API reference
Authentification
Échange des identifiants de clé API contre un access_token, et renouvellement via refresh_token.
Échange serveur-à-serveur : votre backend échange client_id / client_secret contre un
access_token (1h), renouvelable via un refresh_token (30 jours). Voir le
guide Authentification pour le concept.
Le client_secret ne doit jamais transiter par un navigateur ou une app mobile. Ces appels se
font exclusivement depuis votre backend.
Obtenir un token
POST
/sdk/auth/tokenclient_id + secretcurl -X POST 'https://local-cone-api.qcdigitalhub.com/api/v1/sdk/auth/token' \ -H 'Content-Type: application/json' \ -d '{ "client_id": "cli_a1b2c3d4e5f6...", "client_secret": "sk_0f1e2d3c4b5a..."}'Réponse
{ "access_token": "pat_...", "refresh_token": "prt_...", "expires_in": 3600}| Champ | Type | Requis | Description |
|---|---|---|---|
| client_id | string | Oui | Identifiant de la clé, format cli_... |
| client_secret | string | Oui | Secret de la clé, format sk_... |
Réponses 200 token délivré · 401 Invalid credentials.
Rafraîchir le token
POST
/sdk/auth/refreshrefresh_tokencurl -X POST 'https://local-cone-api.qcdigitalhub.com/api/v1/sdk/auth/refresh' \ -H 'Content-Type: application/json' \ -d '{ "refresh_token": "prt_XXXXXXXXXXXXXXXXXXXX"}'Réponse
{ "access_token": "pat_NOUVEAUTOKEN...", "expires_in": 3600}| Champ | Type | Requis | Description |
|---|---|---|---|
| refresh_token | string | Oui | Token prt_... non expiré (< 30 jours) |
Réponses 200 nouvel access_token · 401 Invalid refresh token.
Erreurs d'authentification (401)
| Message | Solution |
|---|---|
Missing access token. | Ajouter Authorization: Bearer <token> |
Invalid access token. | Refaire POST /sdk/auth/token |
Access token expired. | Appeler POST /sdk/auth/refresh |
Developer key revoked. | Régénérer la clé depuis le dashboard |