Skip to main content
Un jeton d’API permet à votre propre système ou au script d’un développeur de travailler avec Zippendo. Vous créez les jetons sous Paramètres → Paramètres de l’API (ouvrez le menu de l’organisation et cliquez sur Gérer). Si un appel est rejeté, la réponse en indique la raison.

​
Ce que vous voyez

  • 401 Unauthorized avec Invalid or expired token ou Authentication required.
  • 403 Forbidden avec Missing required scope ou Vous n’avez pas accès à cette organisation.
  • 429 Too Many Requests avec API rate limit of … requests per minute reached.
  • L’appel fonctionne dans l’application Zippendo, mais échoue depuis votre script ou votre serveur.

​
401 : le jeton n’est pas accepté

Envoyez le jeton ainsi, avec le mot Bearer suivi d’un espace :
Vérifiez que :
  1. Le jeton commence par zipp_ et a été copié en entier, sans espace ni saut de ligne à la fin.
  2. Le jeton existe toujours sous Paramètres de l’API. La suppression d’un jeton l’arrête immédiatement.
  3. Le jeton n’a pas expiré. La colonne Expiration indique la date. Un jeton créé sans Expire dans (jours) n’expire jamais.
Zippendo n’affiche un jeton qu’une seule fois, dans Jeton d’API créé. Si vous ne l’avez plus, créez un nouveau jeton avec Ajouter un jeton d’API et supprimez l’ancien. Voir Créer un jeton d’API.

​
403 : le jeton n’est pas autorisé à faire cela

​
429 : trop d’appels

Chaque formule autorise un certain nombre d’appels d’API par minute : Lorsque vous dépassez la limite, la réponse est API rate limit of … requests per minute reached. Please retry in … s. L’en-tête Retry-After indique combien de secondes attendre. Attendez ce délai, puis réessayez, et espacez vos appels. Plus d’informations : Limites de débit.

​
Vous ne pouvez pas créer d’autre jeton

Vous avez atteint la limite de votre formule. Changez de formule ou supprimez un élément que vous n’utilisez plus. signifie que le nombre de jetons d’API de votre formule est atteint : 2 avec Free, 5 avec Standard, 10 avec Growth, et aucune limite avec Pro et Enterprise. Supprimez un jeton que vous n’utilisez plus, ou changez de formule.

​
Bonnes habitudes

  • Gardez les jetons sur votre serveur. Ne mettez jamais un jeton dans une page de boutique en ligne ni dans un autre code exécuté dans le navigateur d’un client.
  • Donnez à chaque système son propre jeton, avec uniquement les autorisations dont il a besoin. Vous pourrez alors en supprimer un sans arrêter les autres.
À lire aussi : Démarrage rapide de l’API REST, Paramètres de l’API, Présentation de l’API.