> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelinqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Clés API

> Générez et gérez les clés API pour l'API runtime du NBQ Engine.

<Note>
  Les captures d'écran de ce guide peuvent apparaître en français ou en anglais selon les paramètres de langue de votre navigateur. Pour changer la langue du NBQ Studio, modifiez la langue préférée de votre navigateur et rechargez la page.
</Note>

L'onglet **Clé API** est l'endroit où vous créez les clés que votre application utilise pour s'authentifier auprès de l'API runtime.

<Frame>
  <img src="https://mintcdn.com/zelinqa-d77427f3/FpdEzAeb9Hg8n1by/images/backoffice-api-keys.png?fit=max&auto=format&n=FpdEzAeb9Hg8n1by&q=85&s=cd50466aa52f438e9fb999d91060cbdf" alt="Onglet Clés API dans le Zelinqa NBQ Studio" width="2474" height="1176" data-path="images/backoffice-api-keys.png" />
</Frame>

La liste affiche chaque clé masquée (préfixe + 4 derniers caractères), sa date de création et si elle est **Active** ou **Révoquée**. Vous pouvez générer plusieurs clés — par exemple une par environnement — et en révoquer une instantanément.

<Warning>
  L'onglet Clé API est **verrouillé** jusqu'à ce que votre instance NBQ ait au moins **10 questions actives**. Constituez d'abord votre banque de questions, puis revenez ici pour générer une clé.
</Warning>

## Générer une clé

<Steps>
  <Step title="Ouvrir l'onglet Clé API">
    Cliquez sur **Configuration → Clé API** dans la navigation du NBQ Studio.
  </Step>

  <Step title="Cliquer sur Générer une clé">
    Une nouvelle clé est créée immédiatement et affichée en clair — **c'est la seule fois où vous pourrez la voir**.
  </Step>

  <Step title="Copier la clé maintenant">
    Copiez-la et stockez-la comme secret dans votre application (variable d'environnement ou gestionnaire de secrets). Une fois la page quittée, la clé complète ne peut plus être récupérée.
  </Step>
</Steps>

<Warning>
  La clé API est affichée **une seule fois**. Si vous la perdez, révoquez-la et générez-en une nouvelle.
</Warning>

## Format de la clé

Chaque clé du NBQ Engine commence par `nbq_live_` :

```
nbq_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

## Liste des clés

La liste des clés affiche chaque clé **masquée** (préfixe + 4 derniers caractères), sa date de création et son statut (**Active** ou **Révoquée**). Vous pouvez générer plusieurs clés par instance — par exemple, une par environnement.

## Révoquer une clé

Cliquez sur **Révoquer** à côté de la clé souhaitée. Elle cesse de fonctionner immédiatement. Générez une clé de remplacement et mettez à jour votre application.

Pour des conseils de sécurité complets, consultez [Sécurité des clés API](/fr/security/api-key-safety).