API keys

La Zone de Gestion des Clés API dans Paradigm est conçue pour vous donner un contrôle total sur la création, la gestion et l'utilisation des clés API au sein de votre environnement.

Rechercher une clé API Vous pouvez utiliser la barre de recherche pour trouver facilement la clé API que vous recherchez.

Liste des clés API Dans la section Admin/Document, vous pouvez voir une liste complète de toutes les clés API avec les détails suivants :

  • Préfixe : Une séquence de caractères qui identifie le type, l'origine ou la portée de la clé API.
  • Nom unique : Le nom unique associé à la clé API.
  • Créée : La date de création de la clé API.
  • Expire : La date d'expiration de la clé API.
  • A expiré : Indique si la clé API est toujours active. (Rouge = La clé est toujours active ; Vert = Expirée)
  • Révoquée : Indique si la clé API a été désactivée. (Rouge = La clé est active ; Vert = La clé a été révoquée) Vous pouvez supprimer une ou plusieurs clés API en utilisant le menu déroulant "Action".

Voir les détails d'une clé API Lorsque vous accédez aux détails d'une clé API spécifique, vous verrez les informations suivantes :

  • Rôles : Choisissez parmi trois rôles qui déterminent les permissions pour la clé API : Clé API Standard, Clé API Admin, Clé API Projet.
  • Modèles autorisés : Spécifiez si la clé API peut accéder à un ou plusieurs modèles de la liste disponible.
  • Compétences autorisées : Cette fonctionnalité n'est pas encore active.
  • Opt-In : Un paramètre de confidentialité qui détermine si l'utilisation de l'API est suivie. Si la case opt-in n'est pas cochée, aucune donnée d'utilisation ne sera enregistrée.
  • Utilisateur : Chaque clé API est liée à un utilisateur spécifique. Vous pouvez réattribuer la clé API à un autre utilisateur si nécessaire.
  • Préfixe : Une séquence de caractères qui identifie le type, l'origine ou la portée de la clé API (générée automatiquement lors de la création et non modifiable).
  • Nom : Un nom unique pour la clé API, généré lors de la création et non modifiable.
  • Révoquée : Indique si la clé API a été révoquée. Une fois révoquée, elle ne peut pas être réactivée.
  • Expire : Indique la date d'expiration de la clé API. Une fois expirée, la clé n'est plus utilisable.

Éditer/révoquer une clé API Pour éditer ou révoquer une clé API, cliquez sur son préfixe dans la liste. Vous pouvez modifier sa date et heure d'expiration, son nom, son rôle, ses permissions (y compris les modèles et les compétences), et l'utilisateur associé.

Supprimer une clé API : Vous pouvez supprimer définitivement une clé API depuis sa page de détails. Notez que cette action est irréversible.

Créer une nouvelle clé API Pour créer une nouvelle clé API, cliquez sur le bouton "Ajouter une clé API" et remplissez les détails suivants :

  • Expiration : Définissez la date et l'heure d'expiration de la clé API (optionnel ; non modifiable après la création).
  • Nom : Un nom défini par l'utilisateur pour la clé API (50 caractères max ; n'a pas besoin d'être unique).
  • Rôles : Sélectionnez l'un des trois rôles impactant les permissions de la clé API : Clé API Standard (utilisation autonome), Clé API Admin (accès administrateur), Clé API Projet (Application/service web).
  • Modèles autorisés : Spécifiez si la clé API peut appeler un ou plusieurs modèles de la liste disponible.
  • Compétences autorisées : Cette fonctionnalité n'est pas encore active.
  • Opt-In : Un paramètre de confidentialité pour déterminer si l'utilisation de la clé API est suivie. Si la case opt-in n'est pas cochée, aucune donnée d'utilisation ne sera enregistrée.
  • Utilisateur : La clé API doit être associée à un utilisateur, et vous pouvez l'assigner à un autre utilisateur si nécessaire.

Pour créer une nouvelle clé API, cliquez sur le bouton "Ajouter une clé API" en haut à droite ou directement sur "Ajouter" à côté de "Clés API" dans la barre latérale gauche du panneau d'administration. Après avoir défini les paramètres souhaités et cliqué sur sauvegarder, n'oubliez pas de sauvegarder la clé API affichée dans la bannière en haut de votre écran ; elle ne sera plus visible par la suite.