> For the complete documentation index, see [llms.txt](https://docs.abby.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abby.fr/api/authentification.md). # Authentification L'API d'Abby utilise des clés d'authentification pour vérifier les requêtes. Vous pouvez consulter et gérer vos clés depuis les paramètres de votre compte. Vos clés disposent de nombreux droits, veillez à les conserver en sécurité. Évitez de publier votre clé API sur des plateformes publiques comme Github ou côté client. {% hint style="warning" %} Toutes les requêtes doivent être faites en [HTTPS](https://fr.wikipedia.org/wiki/HTTPS). Les appels en HTTP seront rejetés. Les appels sans authentification seront également rejetés. {% endhint %} {% hint style="info" %} **URL:** {% endhint %} ## Créer une clé API Allez sur la page "[integrations](https://my.app-abby.com/settings/integrations)" afin de créer une clé API qui sera associée à votre compte Abby. ![](https://3592603466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE3yh13Zh33m4NDXb9TTQ%2Fuploads%2FG6B9T8UOrEQ3dCc0Pf1r%2Fimage.png?alt=media\&token=d2383068-f301-4244-b97f-756c91c130be) Depuis la pop-up, vous pouvez définir un nom à votre clé API.
Vous ne pourrez pas modifier le nom de la clé après l'avoir créée
Lorsque vous créez votre clé d'API, Abby vous permet de la copier. Copiez-la et conservez-la avec soin. ![Une nouvelle clé API rien que pour vous](https://3592603466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE3yh13Zh33m4NDXb9TTQ%2Fuploads%2F98CQafqQX2Sfpa2cZDkx%2Fimage.png?alt=media\&token=a6ec42f7-2b15-4e65-afc9-a292f93cf670) Si vous égarez votre clé secrète, vous ne pourrez plus y accéder dans le Dashboard. Vous devrez alors remplacer la clé ou en générer une nouvelle. #### Échanger des clés Si vous perdez votre clé API secrète en production, vous ne pouvez pas la récupérer auprès d'Abby. Vous devez la révoquer pour bloquer toute utilisation. Suivez les étapes pour révoquer votre clé et en générer une nouvelle. 1. Allez sur la page "[integrations](https://my.app-abby.com/settings/integrations)" 2. Révoquez votre ancienne clé API ![](https://3592603466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE3yh13Zh33m4NDXb9TTQ%2Fuploads%2FOdTH1qWb63wN7fs0OzUu%2Fimage.png?alt=media\&token=cfab4bec-f7b3-40b5-a965-f044f22a6b25) 4\. Créer une nouvelle clé API ## Utilisation de l'API Pour utiliser votre clé API avec l'authentification Bearer, assurez-vous de l'inclure dans le header `Authorization` de vos requêtes HTTP. Voici un exemple d'utilisation : * **Base URL** : `https://api.app-abby.com` * **Header Authorization** : `Bearer suk-*****` **Exemple de requête HTTP avec la clé API :** ```http GET /endpoint Host: api.app-abby.com Authorization: Bearer suk-***** ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.abby.fr/api/authentification.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.