IPv4 e IPv6 en las API de IP

El tratamiento de IPv4 e IPv6 en las API de IP depende 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 guardar las direcciones

No almacene un campo de una API de IP en un esquema dimensionado solo para IPv4 con puntos. Conserve el texto IPv6 canónico o una representación binaria adecuada, acepte las formas comprimidas en la entrada y pruebe los casos de loopback, direcciones mapeadas o dual-stack según el contrato de la API. Para una solicitud real, consulte la API de 2IP y su contrato vigente.