Cluster C2 : Débogage API
Checklist de workflow de débogage OpenAPI
Beaucoup de bugs API ne viennent pas du code lui-même, mais d'un décalage de contrat entre la spec, le client et le service.
Déboguer dans le bon ordre
Commencer par confirmer l'operation exacte, puis comparer paramètres de chemin, query, headers et body réel.
Si le contrat ciblé n'est pas le bon, consulter les logs trop tôt ne fait qu'ajouter de la confusion.
Comparer à partir des données brutes
- Rejouer la requête avec un outil déterministe et conserver headers + body.
- Comparer code de statut et schema de réponse à la spec point par point.
- Après correction, mettre à jour l'implémentation ou la spec puis relancer la vérification de contrat.
Exemple pratique entrée/sortie
Entrée
spec: POST /orders -> 201 actual: POST /orders -> 200
Sortie
mismatch de contrat détecté action : aligner le service ou la spec sur le code de statut