JSON ou XML pour une API

Le choix entre JSON et XML s’inscrit dans le contrat entre client et API. Le client doit distinguer succès, erreur de validation, échec d’authentification, rate limit et erreur serveur temporaire. Le choix entre JSON et XML ne change pas la sémantique HTTP, et les valeurs IPv4/IPv6 doivent être conservées sans hypothèse de longueur IPv4.

Comment traiter la réponse de l’API

Vérifiez Content-Type, le status code, les champs documentés et le quota. Traitez HTTP 429 séparément, respectez Retry-After et utilisez un exponential backoff borné avec jitter. Tenez compte de l’idempotence avant de réessayer. Journalisez request ID, status et latency, jamais les secrets API.

Le détail important

JSON est souvent compact et se mappe facilement sur objets et tableaux ; XML apporte attributs, espaces de noms et outils de schéma matures. Le choix dépend du contrat de l’API et de son écosystème. Pour une requête réelle et le contrat API actuel, consultez API 2ip.