# Créer et gérer les clés API d’un espace

Source: https://docs.coworkies.com/fr/spaces/api-keys/

> Créez une clé pour un espace Pro, choisissez les permissions et gérez les secrets, la rotation et la révocation.

**API Keys** est visible pour un espace disposant de l’accès Pro. Vous devez aussi être autorisé à gérer cet espace. Les clés créées ici sont liées à cet espace et ne donnent pas un accès global à la plateforme.

## Créer une clé

1. Ouvrez **API Keys** et cliquez sur **Create API Key**.
2. Donnez un **Name** explicite, par exemple `Offres sur notre site`.
3. Choisissez les permissions nécessaires : lecture pour afficher des données, écriture d’offres uniquement pour créer ou retirer des offres.
4. Vous pouvez préciser **Expires in (days)** et les adresses IP sortantes du serveur dans **IP whitelist**.
5. Cliquez sur **Create Key**.
6. Copiez immédiatement la clé complète. Elle n’est révélée qu’à la création ou à la rotation ; la liste affiche une version masquée.
7. Stockez-la dans la configuration secrète du serveur et effectuez la requête de lecture du [guide API](https://docs.coworkies.com/fr/api/).

Les permissions de lecture produisent une clé restreinte ; l’écriture produit une clé live. Ces libellés décrivent les permissions, pas un environnement de test distinct.

Utilisez les en-têtes `X-API-Key` ou `Authorization: Bearer`. Ne placez pas de clé dans un script public, un dépôt, une capture ou une URL.

## Consulter, renouveler ou révoquer

La liste indique l’état, les permissions, la création, la dernière utilisation, le nombre de requêtes et l’expiration éventuelle.

- **Rotate** crée un nouveau secret et révoque l’ancien. Mettez immédiatement l’intégration à jour ; aucune période de chevauchement n’est garantie.
- **Revoke** coupe immédiatement l’accès des outils utilisant cette clé. Vérifiez la clé avant de confirmer.

Si le secret est perdu, créez une nouvelle clé ou effectuez une rotation. Pour une réponse `401`, vérifiez l’état, l’expiration, la révocation et les restrictions IP. Pour `403`, vérifiez les permissions et le périmètre de l’espace.

Consultez [l’authentification et les erreurs API](https://docs.coworkies.com/fr/api/) pour les exemples.