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

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.

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 pour les exemples.