Développeurs

Jeton d'accès

Un jeton de 5 minutes, obtenu avec l'identifiant et le secret de votre client.

POST/identity/api/v1/oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "ptn_…",
  "client_secret": "…",
  "audience": "access-control",
  "scope": "gates:sync gates:keys gates:decisions gates:scans"
}

Le corps peut aussi être envoyé en application/x-www-form-urlencoded, et les identifiants en Authorization: Basic.

{
  "access_token": "eyJ…",
  "token_type": "Bearer",
  "expires_in": 300,
  "scope": "gates:decisions gates:keys gates:scans gates:sync"
}

Envoyez ensuite Authorization: Bearer <access_token> à chaque appel.

Droits

DroitDonne accès à
gates:syncinstantané, changements, accusés
gates:keysla clé A de chaque bracelet dans la synchronisation
gates:decisionsdécisions en ligne et confirmation du passage
gates:scansremontée des passages décidés hors ligne

Durée

  • Le jeton vaut 5 minutes. Gardez-le en mémoire et renouvelez-le environ une minute avant son expiration.
  • Ne demandez pas de jeton à chaque décision : la route du jeton est limitée en débit et répond 429 au-delà.
  • Un composant qui n'a pas besoin des clés, un écran de supervision par exemple, demande un jeton sans gates:keys.

Référence de la route

Sur cette page