Aller au contenu

API publique

Diagnostiquer 401, 403, 422 et 429

401 signifie que la clé n’a pas été acceptée du tout. 403 signifie qu’elle l’a été mais que l’opération n’est pas autorisée. 422 signifie que la requête a été comprise et que la charge utile était fausse. 429 signifie que vous dépassez la limite et devez temporiser.

Étapes

  1. Sur 401, vérifiez que la clé existe, n’a pas expiré et part dans l’en-tête que vous croyez — un collage tronqué en est la cause habituelle.
  2. Sur 403, lisez le code : scope insuffisant, adresse hors liste d’autorisation, ou clé d’un autre espace. Se reconnecter n’aidera pas ; la permission doit changer.
  3. Sur 422, lisez le champ que la réponse nomme et corrigez la charge utile.
  4. Sur 429, respectez les en-têtes de limite et temporisez. Réessayer aussitôt aggrave la situation.
  5. Conservez le requestId de la réponse — c’est lui qui permet à l’assistance de retrouver votre appel exact.

Comment vérifier le résultat

La même requête réussit après correction, et la réponse porte un statut 2xx avec l’objet attendu.

Ce qui coince le plus souvent

  • Traiter un 403 comme une mauvaise clé et la réémettre, ce qui ne change rien.
  • Réessayer un 429 dans une boucle serrée.
  • Envoyer la clé à l’assistance au lieu de l’identifiant de requête.
Cela a-t-il réglé votre problème ?

Cela n’a pas aidé

Écrivez-nous en précisant la plateforme et la version, les étapes suivies, le résultat attendu et l’espace de travail ou le QR code concerné. Masquez tout secret avant de joindre quoi que ce soit.

Écrire à l’assistance