Guide de dépannage API

Ce guide aide à diagnostiquer les problèmes les plus courants rencontrés avec les Partner APIs et la Tenant Public API.

Commencez par identifier à quel moment le problème apparaît.

Diagnostic rapide

Symptôme	Vérification prioritaire	Page
401 Unauthorized	Token absent, invalide ou expiré	Authentification et autorisation
403 Forbidden	Scope, ownership ou contexte d'organisation	Authentification et autorisation
400 Bad Request	Content-Type, JSON, champs et paramètres	Requêtes et validation
404 Not Found	Identifiant, tenant ou ressource ciblée	Requêtes et validation
409 Conflict	État de la ressource / opération déjà réalisée	Requêtes et validation
422	Document ou règle fonctionnelle non acceptable	Requêtes et validation
429 Too Many Requests	Rate limiting / fréquence de polling	Rate limiting et résilience
202 Accepted mais pas de résultat final	Traitement asynchrone	Asynchronisme et statuts
Flux Ok mais statut métier inattendu	Statut technique ≠ statut métier	Asynchronisme et statuts
Impossible de corréler un incident	Identifiants de trace manquants	Tracer et escalader

Ordre de vérification recommandé

Avant de chercher plus loin

Vérifiez systématiquement :

• que vous utilisez la SANDBOX ;
• que le host correspond à l'API attendue ;
• que la méthode HTTP est celle du Swagger ;
• que le token a été obtenu avec les bons credentials ;
• que les headers de contexte sont présents ;
• que le Content-Type correspond réellement au body envoyé ;
• que vous n'utilisez pas un identifiant d'un autre tenant ou d'une autre ressource ;
• que vous distinguez un succès HTTP initial du résultat final d'un traitement asynchrone.

Références techniques

➡️ Swagger Partner APIs — SANDBOX
➡️ Swagger Tenant Public API — SANDBOX
➡️ Integration Guidelines
➡️ Collections Postman