Cluster C2 : Débogage API
Comment mocker OpenAPI rapidement
Un bon mock ne consiste pas seulement à renvoyer des données vite. Il doit rester aligné sur les codes de statut, les champs et les schémas du contrat.
Le bon ordre pour mocker vite
Commencer par confirmer l'operation ciblée, les paramètres et le schema de réponse, puis générer des exemples déterministes.
Si on écrit du faux JSON avant de regarder le schema, le mock devient rapidement peu fiable pour tout le monde.
Garder le mock utile dans la durée
- Stabiliser codes HTTP et headers critiques.
- Conserver les exemples sous forme de fixtures rejouables.
- Mettre à jour en même temps le mock et ses snapshots quand le contrat change.
Exemple pratique entrée/sortie
Entrée
GET /users/{id}
response schema: UserSortie
200 application/json
{"id":"u_123","name":"Ava","role":"admin"}