API JSON frente a XML

La elección entre JSON y XML forma parte del contrato entre un cliente y una API. Un cliente debe distinguir entre éxito, errores de validación, fallos de autenticación, límites de frecuencia y errores temporales del servidor. Elegir JSON o XML no cambia la semántica de HTTP, y las direcciones IPv4/IPv6 deben guardarse íntegras, sin presuponer la longitud de una IPv4.

Cómo gestionar la respuesta

Valide Content-Type, el código de estado, los campos documentados y la cuota. Trate HTTP 429 por separado, respete Retry-After cuando se indique y utilice un backoff exponencial acotado con jitter. Tenga en cuenta la idempotencia antes de reintentar. Registre los identificadores de solicitud, el estado y la latencia, pero nunca los secretos de la API.

Cómo elegir el formato

JSON se corresponde de forma natural con los modelos de datos habituales de objetos y arrays, y suele ser compacto; XML admite atributos, espacios de nombres y herramientas de esquema maduras. Elija según el contrato de la API y su ecosistema, en lugar de suponer que un formato es universalmente más rápido o más correcto. Si quiere probar una solicitud real, consulte la API de 2IP y su contrato vigente.