Authentification SDK
Comment votre backend échange ses identifiants de clé API contre un token d'accès, et comment gérer le cycle de vie des tokens.
L'API SDK utilise un échange serveur-à-serveur : votre backend échange un couple
client_id / client_secret contre un access_token, puis passe ce token dans l'en-tête
Authorization: Bearer de chaque appel SDK.
Le client_secret ne doit jamais transiter par un navigateur ou une application mobile.
Appelez les endpoints d'authentification exclusivement depuis votre serveur backend.
Cycle de vie des tokens
access_token
Préfixe pat_ valable 1 heure. À passer dans Authorization: Bearer sur chaque appel SDK.
refresh_token
Préfixe prt_ valable 30 jours. Renouvelle l'access_token sans re-saisir les credentials.
Flux recommandé
Obtenez un premier couple de tokens via POST /sdk/auth/token.
access_token sur vos appels SDK pendant 1 heure.À l'expiration (401 Access token expired.), appelez POST /sdk/auth/refresh avec le refresh_token.
Au bout de 30 jours (ou 401 Invalid refresh token.), refaites un POST /sdk/auth/token.
Erreurs d'authentification (401)
| Message | Solution |
|---|---|
Missing access token. | Ajouter l'en-tête Authorization: Bearer <token> |
Invalid access token. | Vérifier le token, refaire /sdk/auth/token |
Access token expired. | Appeler POST /sdk/auth/refresh |
Developer key revoked. | Régénérer la clé depuis le dashboard |
Invalid credentials. | Vérifier client_id / client_secret |
Invalid refresh token. | Refaire POST /sdk/auth/token |
Sandbox vs Production
Eliptik propose deux modes de fonctionnement contrôlés par le drapeau is_sandbox de la clé API utilisée et non par l'URL.
Collection Postman
Démarrez rapidement avec notre collection Postman officielle tous les endpoints pré-configurés, scripts automatiques de gestion des tokens, et deux environnements (Sandbox et Production).