> For the complete documentation index, see [llms.txt](https://guides.ia.numerique.gouv.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.ia.numerique.gouv.fr/albert-api/compte-and-usage/api-keys.md).
# Clefs API
Albert API utilise un système de clef pour authentifier vos requêtes. Ces clefs sont des **Bearer** tokens, une chaine de caractères alphanumérique unique et secrète commencant par `sk-`. **Ces clefs d'API doivent être stockées en lieu sécurisé et ne doivent jamais être divulguées.**
### Création d'une clef
Vous pouvez créer des clefs d'API de 2 manières, par API ou sur le Playground.
{% tabs %}
{% tab title="Playground" icon="globe-pointer" %}
Connectez-vous sur le [playground](https://albert.playground.etalab.gouv.fr/), rendez-vous dans la page *API Keys* et cliquez sur le bouton *Create key*.
**Attention, la clef est affichée intégralement une seule fois à la création.** Vous devez la copier dans un endroit sécurisé.
{% endtab %}
{% tab title="API" icon="square-terminal" %}
Vous pouvez créer une clef d'API en appelant le endpout POST `/v1/keys`. **Attention, vous devez disposer d'une clef API existante pour créer une nouvelle clef.** Cette méthode de création est utilisée pour renouveler des clefs de manière automatique. Si vous ne disposez pas d'une clef API existante, vous pouvez en créer une sur le Playground.
Remplacez `$ALBERT_API_KEY` par une clef non expirée dans la commande ci-dessous.
```
curl -X POST "https://albert.api.etalab.gouv.fr/v1/keys" \
-H "Authorization: Bearer $ALBERT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "my-new-key", "expires": null}'
```
Pour en savoir plus sur les endpoints `/v1/keys`, consultez l'API Reference [ici](https://guides.ia.numerique.gouv.fr/albert-api/api-reference/liste-des-endpoint/keys).
{% endtab %}
{% endtabs %}
### Expiration des clefs
**Toutes les clefs API ont une date d'expiration de maximum 1 an à compter de la date de création.** Vous pouvez configurer une clef avec une date d'expiration inférieure à 1 an lors de la création. Il est en revanche impossible d'obtenir une clef sans expiration pour des raisons de sécurité.
**Exemple de requête :**
### Consulter ses clefs
{% tabs %}
{% tab title="Playground" icon="globe-pointer" %}
Vous pouvez consulter vos clefs sur la page *API Keys* du [Playground](https://albert.playground.etalab.gouv.fr/).
{% endtab %}
{% tab title="API" icon="square-terminal" %}
Vous pouvez consulter vos clefs en appelant le endpoint GET `/v1/keys`.
Remplacez `$ALBERT_API_KEY` par une clef non expirée dans la commande ci-dessous.
```
curl -X GET "https://albert.api.etalab.gouv.fr/v1/keys" \
-H "Authorization: Bearer $ALBERT_API_KEY"
```
Vous pouvez également récupérer le détail d'une clef en appelant le endpoint GET `/v1/keys/{key}`.
```
curl -X GET "https://albert.api.etalab.gouv.fr/v1/keys/{key}" \
-H "Authorization: Bearer $ALBERT_API_KEY"
```
Remplacez `{key}` par l'identifiant de la clef que vous souhaitez récupérer.
Pour en savoir plus sur les endpoints `/v1/keys`, consultez l'API Reference [ici](https://guides.ia.numerique.gouv.fr/albert-api/api-reference/liste-des-endpoint/keys).
{% endtab %}
{% endtabs %}
## Révoquer une clef
{% tabs %}
{% tab title="Playground" icon="globe-pointer" %}
Vous pouvez révoquer une clef sur la page *API Keys* du [Playground](https://albert.playground.etalab.gouv.fr/) en cliquant sur le bouton *Delete* de la clef que vous souhaitez révoquer.
**Attention, cette action est irréversible.** Une fois une clef révoquée, elle ne peut plus être utilisée.
{% endtab %}
{% tab title="API" icon="square-terminal" %}
Vous pouvez révoquer une clef en appelant le endpoint DELETE `/v1/keys/{key}`.
```
curl -X DELETE "https://albert.api.etalab.gouv.fr/v1/keys/{key}" \
-H "Authorization: Bearer $ALBERT_API_KEY"
```
Remplacez `{key}` par l'identifiant de la clef que vous souhaitez révoquer et `$ALBERT_API_KEY` par une clef non expirée dans la commande ci-dessous.
**Attention, cette action est irréversible.** Une fois une clef révoquée, elle ne peut plus être utilisée.
Pour en savoir plus sur les endpoints `/v1/keys`, consultez l'API Reference [ici](https://guides.ia.numerique.gouv.fr/albert-api/api-reference/liste-des-endpoint/keys).
{% endtab %}
{% endtabs %}
### Limites de consommation
Toutes vos clefs d'API partagent les mêmes limites de consommation. En effet, ces limites sont appliquées au niveau de votre utilisateur. Pour en savoir plus sur les limites de consommation, consultez la section [Quotas & limites](/albert-api/compte-and-usage/quotas.md).
---
# 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://guides.ia.numerique.gouv.fr/albert-api/compte-and-usage/api-keys.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.
