---
title: "Clés d'API"
description: "Créez une clé d'API à portées limitées pour votre compte Matchai, utilisez-la comme jeton de porteur, protégez-la, renouvelez-la, révoquez-la. Pour vos outils."
last_updated: "2026-10-21"
lang: "fr-CA"
status: "coming-soon"
canonical: "https://matchai.co/docs/fr/developers/authentication/api-keys"
---
# Clés d'API
> Créez une clé d'API à portées limitées pour votre compte Matchai, utilisez-la comme jeton de porteur, protégez-la, renouvelez-la, révoquez-la. Pour vos outils.
**Bientôt disponible. Cette fonctionnalité est documentée avant son lancement pour que vous puissiez planifier votre intégration; elle n’est pas encore offerte.**
Source: https://matchai.co/docs/fr/developers/authentication/api-keys
Une clé d'API permet à votre propre code d'agir sur votre propre compte Matchai. C'est la façon la plus simple d'accéder à l'API : aucune application à enregistrer, aucun flux de connexion, un seul en-tête dans chaque requête.
Utilisez une clé pour vos propres scripts et vos propres outils IA. Si vous bâtissez quelque chose que d'autres professionnels utiliseront, utilisez plutôt [Se connecter avec Matchai](https://matchai.co/docs/fr/developers/authentication/connect-with-matchai). Consultez [Les clés servent à votre propre compte](#keys-are-for-your-own-account).
## Ce qu'est une clé [#what-a-key-is]
- **Elle atteint exactement un compte** : celui qui l'a créée.
- **Elle porte les portées que vous avez choisies** quand vous l'avez créée, et rien d'autre. Une clé avec `listings:read` ne peut pas modifier une inscription.
- **Elle peut être révoquée en tout temps**, par vous, depuis Matchai.
- **Elle appartient à la connexion Accès à l'API de votre compte.** L'Accès à l'API est un connecteur Matchai, comme Claude ou ChatGPT, et apparaît sur la page Connecteurs. C'est une seule connexion, peu importe le nombre de clés que vous créez, et les clés ne sont jamais facturées une à une. La page Connecteurs indique ce que coûte la connexion.
## Créer une clé [#create-a-key]
Ouvrez **Paramètres → Connecteurs** dans Matchai et déployez **Options avancées (pour les développeurs)**.
Allez à **Clés d'API** et créez une clé. Donnez-lui un nom qui dit où elle s'exécutera, comme « Synchronisation des inscriptions » ou « Tableau de bord du bureau ». Vous l'apprécierez quand vous en aurez cinq.
Choisissez ses portées. Ne choisissez que ce dont le code a besoin. Le [tableau des portées](https://matchai.co/docs/fr/developers/authentication#scopes) les énumère toutes.
Copiez la clé. **Matchai ne l'affiche qu'une fois.** Ensuite, la liste ne montre que le nom de la clé, ses premiers caractères, ses portées et sa dernière utilisation. Si vous perdez une clé, créez-en une nouvelle et révoquez l'ancienne.
## Format des clés [#key-format]
Une clé est formée de `matchai_` suivi d'une longue chaîne aléatoire de lettres et de chiffres. La partie aléatoire ne contient ni tirets ni traits de soulignement, alors un double-clic sélectionne toute la clé et un seul motif permet de la trouver :
```text title="Pattern"
matchai_[A-Za-z0-9]+
```
Traitez une clé comme une chaîne opaque. Ne l'analysez pas, et ne vous fiez pas à sa longueur. Le préfixe `matchai_` est propre à Matchai, ce qui permet aux outils de détection de secrets de reconnaître une clé qui se retrouve dans un dépôt.
## Utiliser une clé [#use-a-key]
Envoyez la clé comme jeton de porteur dans chaque requête :
```bash title="Terminal"
curl https://api.matchai.co/v1/me \
-H "Authorization: Bearer $MATCHAI_API_KEY"
```
```js title="client.mjs"
export async function matchai(path, init = {}) {
const response = await fetch(`https://api.matchai.co/v1${path}`, {
...init,
headers: {
...init.headers,
Authorization: `Bearer ${process.env.MATCHAI_API_KEY}`,
},
});
if (!response.ok && response.status !== 202) {
const { error } = await response.json();
throw new Error(`${error.code}: ${error.message} (request ${error.request_id})`);
}
return response;
}
```
```python title="client.py"
import os
import requests
def matchai(method, path, **kwargs):
headers = {"Authorization": f"Bearer {os.environ['MATCHAI_API_KEY']}"}
headers.update(kwargs.pop("headers", {}))
response = requests.request(
method, f"https://api.matchai.co/v1{path}", headers=headers, timeout=30, **kwargs
)
if not response.ok:
error = response.json()["error"]
raise RuntimeError(f"{error['code']}: {error['message']} (request {error['request_id']})")
return response
```
Une requête qui ne porte aucune clé, ou une clé révoquée ou mal saisie, reçoit la réponse `401`.
## Protéger une clé [#keep-a-key-safe]
- **Gardez-la sur un serveur que vous contrôlez.** Lisez-la depuis une variable d'environnement ou un gestionnaire de secrets. Ne la mettez jamais dans du code exécuté dans un navigateur, une application mobile, un dépôt public, une ligne de journal ou un message de clavardage : quiconque peut la lire peut agir en votre nom.
- **Utilisez une clé par script ou par environnement.** Une clé distincte pour le développement et pour la production vous permet d'en révoquer une sans arrêter l'autre.
- **Donnez à chaque clé le moins de portées possible.** Un script qui ne fait que lire des inscriptions n'a aucun besoin de `contacts:write`.
- **Révoquez une clé dès que vous avez un doute.** Une nouvelle clé ne coûte rien. Consultez [Révoquer une clé](#revoke-a-key).
## Renouveler une clé [#rotate-a-key]
Renouvelez vos clés selon un calendrier que vous pouvez respecter, et tout de suite si une clé a pu être vue. Plusieurs clés fonctionnent en même temps, alors le renouvellement ne demande aucune interruption de service :
Créez une nouvelle clé avec les mêmes portées.
Déployez-la dans le code qui utilise l'ancienne.
Vérifiez dans la liste des clés que la date de dernière utilisation de l'ancienne clé ne bouge plus.
Révoquez l'ancienne clé.
Toutes les clés d'un même compte partagent sa connexion Accès à l'API, alors elles partagent aussi la [limite de débit](https://matchai.co/docs/fr/developers/rate-limits) et la limite d'énergie de la connexion.
## Révoquer une clé [#revoke-a-key]
Ouvrez **Paramètres → Connecteurs → Options avancées (pour les développeurs) → Clés d'API** et révoquez la clé. À partir de ce moment, les requêtes qui l'utilisent reçoivent la réponse `401`.
Pour arrêter toutes les clés d'un coup, déconnectez **Accès à l'API** sur la page Connecteurs. Une connexion qui prend fin arrête toutes ses clés.
## Les clés servent à votre propre compte [#keys-are-for-your-own-account]
Une clé personnelle sert à votre propre compte. Les [conditions d'utilisation](https://matchai.co/terms) de Matchai ne vous permettent pas d'utiliser des clés personnelles pour exploiter un service pour d'autres personnes.
Si d'autres professionnels utiliseront ce que vous bâtissez, comme un créateur de sites Web, un CRM ou un assistant IA, [créez une application Matchai](https://matchai.co/docs/fr/developers/authentication/create-a-matchai-app) et utilisez [Se connecter avec Matchai](https://matchai.co/docs/fr/developers/authentication/connect-with-matchai). Chaque professionnel voit alors ce que votre application peut faire et qui paie, donne son accord en appuyant une seule fois sur **Autoriser**, et peut déconnecter l'application quand il le veut. C'est aussi ce qui garantit que ses données restent les siennes.
## Actions finales [#final-actions]
L'Accès à l'API a le même réglage pour les actions finales que toute autre connexion, et il commence sur **Me demander**. Un script qui envoie un message, publie une inscription ou supprime quelque chose reçoit `202 Accepted` et attend que vous approuviez l'action dans Matchai. Écrivez vos scripts pour qu'ils gèrent les deux réponses : la section [Actions finales](https://matchai.co/docs/fr/developers/authentication#final-actions) montre comment.
## Erreurs possibles [#errors-you-may-meet]
| Statut | Code ou type d'erreur | Quoi faire |
|---|---|---|
| `401` | `authentication_error` | La clé est absente, mal saisie ou révoquée. Créez une nouvelle clé. |
| `402` | `insufficient_energy` ou `energy_limit_reached` | Le compte n'a plus d'Énergie Matchai, ou la connexion a atteint sa limite d'énergie. Rien n'a été fait. |
| `403` | `scope_missing` | Il manque une portée à la clé. Le message la nomme. Créez une clé qui l'inclut. |
| `429` | `rate_limited` | Trop de requêtes. Attendez le nombre de secondes indiqué par `Retry-After`. |
La page [Erreurs](https://matchai.co/docs/fr/developers/errors) couvre chaque code.
Faites vos premiers appels avec une nouvelle clé.
Pour les applications qui servent d'autres professionnels.
Les portées, les actions finales et les limites d'énergie.
## Sitemap
- [Toutes les pages de la documentation Matchai](https://matchai.co/docs/sitemap.md)
- [llms.txt](https://matchai.co/docs/fr/llms.txt)