ip-api.com suele ser el primer servicio de geolocalización de IP al que recurre un desarrollador, sobre todo porque es rápido de probar y fácil de integrar en un script. Esa misma sencillez es justo lo que nuestro host compatible está diseñado para conservar, con un conjunto diferente de reglas de cuota y precios detrás.
El host reproduce exactamente el tratamiento de las solicitudes y el cuerpo de respuesta de ip-api.com, salvo los textos de copyright, términos y privacidad, que son nuestros. Una solicitud que antes iba al endpoint de ip-api.com puede ir al nuestro, y el JSON que vuelve se analiza de la misma forma, con los mismos nombres de campo en los mismos lugares.
Como /v1/ip resuelve por completo ambas familias de direcciones, este host compatible trata las consultas IPv4 e IPv6 de la misma forma. Una consulta de una dirección IPv4 y una de una dirección IPv6 vuelven con la estructura correcta, sin necesidad de ningún indicador extra que le diga al host qué tipo de dirección está consultando.
Las claves se autentican aquí igual que en el resto de My Geocode: como cabecera X-API-Key, como cabecera Authorization: Bearer, mediante autenticación HTTP Basic con la clave como nombre de usuario o como parámetro de consulta. El estilo que ya use tu integración actual se acepta sin modificaciones.
Los precios de este host son iguales a los de cualquier otro host y endpoint que operamos. Cualquier dirección recibe 2.500 consultas de IP gratuitas al día sin ninguna clave, contadas por red. Una clave añade sus propias 2.500 solicitudes gratuitas al día, por separado. Más allá de eso, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited lo cubre todo por 50 € al mes, sin recargo por usar un host compatible en lugar de /v1/ip directamente.
Las cabeceras de cuota acompañan también aquí a cada respuesta, algo que una integración simple con ip-api.com normalmente no muestra por sí sola: se incluyen X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit y X-Quota-Reset.
Para los proyectos que quieren más que una consulta estándar, añadir mg_extras=1 a la solicitud, o enviar una cabecera X-MG-Extras, agrega campos opcionales como detalles de amenazas y de red de la IP sobre la respuesta compatible, sin cambiar su estructura base a menos que lo pidas.
Todos los detalles están en /compatibility/ip-api/. Si algún script de tu stack ya se comunica con ip-api.com, redirigirlo aquí es una forma rápida de ver la diferencia que supone un host con cuotas visibles y precios en EUR.