Authentification
Demandez un jeton d'accès machine à machine et utilisez-le en toute sécurité avec les endpoints API OmniLab approuvés.
Votre backend échange ses identifiants client contre un jeton, puis envoie ce jeton à chaque appel.
Avant de commencer
- Un
client_id, unclient_secretet uneaudiencepour chaque environnement. Ils ne sont pas en libre-service : demandez-les à votre Customer Success Manager, et faites-vous confirmer les endpoints activés pour vous. - Votre hôte API pour chaque environnement, listé dans URL de base et environnements.
- Un serveur que vous contrôlez pour la demande de jeton, jamais du code navigateur ni le bundle d'une app mobile.
Demander un jeton
-
Stockez séparément les identifiants de production et de staging, dans un gestionnaire de secrets.
-
Appelez
POST https://<api-host>/v1/oauth:tokenavec un corps JSON :curl -X POST "https://<api-host>/v1/oauth:token" \ -H "Content-Type: application/json" \ -d '{ "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET", "audience": "YOUR_AUDIENCE", "grant_type": "client_credentials" }' -
Lisez le jeton dans la réponse :
{ "access_token": "YOUR_ACCESS_TOKEN", "token_type": "Bearer", "expires_in": 3600 }expires_inest la durée de vie du jeton, en secondes. Une nouvelle demande pendant sa validité peut renvoyer le même jeton, avec le mêmeexpires_in: mettez donc le jeton en cache, et calculez son expiration à partir de la première réponse. -
Envoyez le jeton dans l'en-tête
Authorizationde chaque requête API :Authorization: Bearer YOUR_ACCESS_TOKEN
Quand une demande de jeton ou un appel échoue
| Réponse | Cause | Que faire |
|---|---|---|
400 sur la demande de jeton | Il manque client_id ou client_secret | Envoyez les deux, puis réessayez |
500 sur la demande de jeton | Les identifiants ont été refusés, ou aucun jeton n'a pu être émis | Vérifiez les identifiants et l'audience avant de réessayer |
401 sur un appel API | Le jeton est absent, expiré ou mal formé, ou appartient à l'hôte d'un autre compte | Demandez un nouveau jeton, puis réessayez une fois |
Un jeton ne fonctionne que sur l'hôte API du compte pour lequel il a été émis.
Règles de sécurité essentielles
- N'exposez jamais le
client_secretdans du JavaScript navigateur, une page de borne ou le bundle d'une app mobile. - Gardez l'échange de jeton sur votre propre backend, puis appelez l'API de serveur à serveur.
- Stockez des identifiants distincts par environnement.
- Demandez à votre Customer Success Manager de renouveler les identifiants compromis ou qui ne servent plus.
- Journalisez de votre côté les ID de requête et les horodatages, mais jamais les secrets complets ni les jetons d'accès complets.