Clés API
Créer, lister, révoquer et régénérer les couples client_id / client_secret. Toutes ces routes nécessitent le token Keycloak du dashboard.
Les clés API permettent à votre backend de s'authentifier auprès de l'API SDK. Toutes ces routes
nécessitent le token Keycloak du dashboard (Authorization: Bearer <kc_token>).
Le client_secret n'est affiché qu'une seule fois (création / régénération). Stockez-le
immédiatement dans un gestionnaire de secrets.
Créer une clé
/developer/keysKeycloakcurl -X POST 'https://local-cone-api.qcdigitalhub.com/api/v1/developer/keys' \ -H 'Authorization: Bearer <kc_token>' \ -H 'Content-Type: application/json' \ -d '{ "name": "Mon intégration", "is_sandbox": true}'Réponse
{ "success": true, "data": { "client_id": "cli_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6", "client_secret": "sk_0f1e2d3c4b5a6978...", "is_sandbox": true }}| Champ | Type | Requis | Défaut | Description |
|---|---|---|---|---|
| name | string | Non | null | Nom de la clé, max 255 caractères |
| is_sandbox | boolean | Non | true | true = test, false = production |
Lister ses clés
/developer/keysKeycloakcurl -X GET 'https://local-cone-api.qcdigitalhub.com/api/v1/developer/keys' \ -H 'Authorization: Bearer <kc_token>'Réponse
{ "success": true, "data": [ { "developer_keys_id": "aB3xY9", "client_id": "cli_...", "name": "Mon intégration", "is_sandbox": true, "last_used_at": "2026-06-25T09:30:00Z", "revoked_at": null, "created_at": "2026-06-01T10:00:00Z" } ]}Le client_secret n'est jamais retourné. Groupez par is_sandbox pour distinguer Sandbox / Production.
Détail d'une clé
/developer/keys/{key_id}Keycloakcurl -X GET 'https://local-cone-api.qcdigitalhub.com/api/v1/developer/keys/{key_id}' \ -H 'Authorization: Bearer <kc_token>'Paramètre d'URL : key_id (string, hashid). Réponses 200 · 403 non propriétaire · 404 introuvable.
Révoquer une clé
/developer/keys/{key_id}Keycloakcurl -X DELETE 'https://local-cone-api.qcdigitalhub.com/api/v1/developer/keys/{key_id}' \ -H 'Authorization: Bearer <kc_token>'Réponse
{ "success": true, "message": "API key revoked successfully."}Renseigne revoked_at. Les access_token issus de cette clé renverront ensuite
401 Developer key revoked. Réponses 200 · 403 non propriétaire.
Régénérer une clé
/developer/keys/{key_id}/regenerateKeycloakcurl -X POST 'https://local-cone-api.qcdigitalhub.com/api/v1/developer/keys/{key_id}/regenerate' \ -H 'Authorization: Bearer <kc_token>'Réponse
{ "success": true, "data": { "client_id": "cli_nouveauId...", "client_secret": "sk_nouveauSecret..." }}Nouveau couple d'identifiants, clé réactivée (revoked_at = null), is_sandbox conservé. Les
anciens identifiants cessent de fonctionner. Réponses 200 · 403 non propriétaire.