Muchas aplicaciones recurren a la geolocalización de IP una sola vez, en el momento en que un usuario se conecta por primera vez, para deducir un país o fijar una moneda por defecto y seguir adelante. ipstack ha sido durante mucho tiempo una opción habitual para ese único paso. Nuestro nuevo host compatible permite que ese paso siga funcionando igual, con otro backend detrás.
El host replica con precisión los parámetros de solicitud y el cuerpo de respuesta de ipstack, salvo los textos de copyright, términos y privacidad, que corresponden a My Geocode y no al proveedor original. Allí donde tu aplicación envía hoy una consulta con la forma de ipstack, puede enviar esa misma consulta a nuestro host, y los campos que vuelven quedan en los mismos lugares que espera tu código de análisis existente.
Ambas familias de direcciones se admiten por completo aquí, igual que /v1/ip funciona en el resto de la plataforma. Una dirección IPv4 y una dirección IPv6 se resuelven correctamente en este host, con la misma estructura de respuesta en ambos casos.
Las claves pueden enviarse 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, según el patrón que ya use tu integración actual con ipstack. Las cuatro se aceptan exactamente igual en todos los hosts y endpoints que operamos, así que el código de autenticación rara vez necesita cambiar.
Los precios detrás de este host son los mismos que en todas partes. Cualquier dirección recibe 2.500 consultas gratuitas al día sin necesidad de clave, contadas por red para que una oficina o un edificio compartido consuman de una sola bolsa y no de muchas. Una clave añade por su cuenta otras 2.500 solicitudes gratuitas al día. Superadas esas cuotas, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited lo cubre por 50 € al mes, sin una tarifa aparte para este host compatible.
Cada respuesta incluye además nuestro conjunto completo de cabeceras de cuota, algo que una integración simple con ipstack no expondría: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used y X-Credits-Remaining están presentes, llamada tras llamada.
Si tu proyecto quiere más que la respuesta estándar, mg_extras=1 en la solicitud, o una cabecera X-MG-Extras, agrega campos opcionales, como detalles de amenazas y de red de la IP, sobre la estructura compatible. Está desactivado por defecto, así que nada cambia en el formato de respuesta a menos que lo pidas expresamente.
El host compatible está documentado en /compatibility/ipstack/, y la referencia completa de consulta de IP en /docs/ipv4-lookup/ y /docs/ipv6-lookup/ cubre todo lo que hay debajo.