> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/ia-et-api/secrets-api.md).

# Secrets et requêtes API

Pour stocker une clé, ouvrez les **Secrets** dans la barre du builder ou **Gérer les secrets** dans la configuration d’une requête API. Ajoutez un nom puis la valeur via le formulaire de secret. Référencez-la par `{secret.nom}` dans un champ prévu. Gardez les clés hors des messages Discord, prompts et codes de partage.

[Requête API](/reference/blocs/api-request.md) fournit les paramètres d’URL, les en-têtes, le corps selon la méthode, un délai maximum et le test de réponse. Dans **Test & résultats**, choisissez les champs JSON à exposer comme variables. Testez d’abord sur une destination de lecture dont vous pouvez vérifier le résultat.

![Dialogue de configuration d’une requête avec une adresse de démonstration](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-c44c7b2cb52f609add7d4ab43c65d51c0e2eb452%2Fconfig-api.png?alt=media)

| Contexte              | Règles                                                                                                                                       |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Commande ou événement | Requête HTTP(S) selon la méthode et les règles de destination du moteur.                                                                     |
| Outil                 | GET/HEAD, HTTPS, paramètres fixes, en-têtes fixes ou références à des secrets. Une URL dynamique exige une liste de destinations approuvées. |
| Modèle externe        | Sélectionnez le secret qui contient la clé personnelle de ce fournisseur.                                                                    |

Un propriétaire peut déléguer l’usage ou la gestion des secrets séparément depuis [Collaboration](/gestion-du-bot/collaboration.md). Un agent disponible est nécessaire pour les opérations sur le coffre de ce bot.
