Passer au contenu principal
Envoyez un jeton de type Bearer dans l’en-tête Authorization à chaque appel :
Quelques points de terminaison, comme la connexion des applications mobiles, ne prennent pas de jeton, et leur entrée dans la référence de l’API le précise. Il existe deux types de jetons. Une fois reçus, l’API les traite de la même façon.

​
Clés d’API

Paramètres > Accès > Clés d’API liste les clés de l’organisation avec leur nom, leur propriétaire, leurs portées, leur date de création, leur date d’expiration et leur dernière utilisation. Pour en créer une, appuyez sur Nouvelle clé d’API, donnez-lui un nom, choisissez une date d’expiration (ou aucune) et cochez les portées dont elle a besoin. Copiez la clé quand elle s’affiche, car elle ne sera plus jamais affichée. Les clés qui expirent sont plus sûres. Une clé appartient au membre qui l’a créée et à l’organisation dans laquelle elle a été créée :
  • Elle ne peut jamais faire plus que ce membre. Chaque appel exige à la fois l’autorisation du membre et l’une des portées de la clé. Consultez Autorisations et portées.
  • Elle ne peut accéder à aucune autre organisation.
  • Si le membre quitte l’organisation, la clé cesse de fonctionner.
Appuyez sur Révoquer pour arrêter une clé immédiatement. Tout ce qui l’utilise reçoit dès lors un 401, et la clé reste dans la liste, marquée comme révoquée.

​
Quand un jeton échoue

Gardez les clés hors du contrôle de version et du code côté client. Chargez-les depuis votre gestionnaire de secrets ou votre environnement, comme le font les exemples ici avec STOCKSHIFT_TOKEN.