# 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:** <https://api.app-abby.com>
{% 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.

<div align="center"><img src="https://3592603466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE3yh13Zh33m4NDXb9TTQ%2Fuploads%2FMr7VLsUJGqzo4zH7YOEz%2Fimage.png?alt=media&#x26;token=f954e21f-0d61-4a82-b4a8-82271ec9ea75" alt="Vous ne pourrez pas modifier le nom de la clé après l&#x27;avoir créée"></div>

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 <a href="#rolling-keys" id="rolling-keys"></a>

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: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.abby.fr/api/authentification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.