My Geocode

Migración

Migrar desde ip-api.com

· 2 min de lectura · My Geocode · #ip-api#geolocalización-ip#migración#compatibilidad#api

ip-api.com se ganó sus seguidores con un formato de respuesta realmente sencillo: un objeto JSON plano por consulta con campos como country, regionName, city, lat, lon, isp y query, que contiene la dirección IP consultada, prácticamente sin anidamiento. Esa estructura plana lo convirtió en una primera opción habitual para cualquiera que quisiera añadir geolocalización de IP básica a un proyecto sin aprender un esquema más elaborado.

La geolocalización de IP es una de las consultas en las que se puede mostrar que los resultados funcionan realmente de principio a fin, a diferencia de la geocodificación o el autocompletado, de los que solo se describe la forma. Una solicitud con una dirección IPv4 o IPv6 devuelve país, región, ciudad, coordenadas e información de red a partir de datos que se mantienen actualizados mediante nuestra propia canalización de caché, en lugar de un conjunto de datos estático o que se actualiza lentamente.

El host compatible con ip-api de My Geocode reproduce exactamente la estructura de campos plana, incluidos country, regionName, city, lat, lon, isp y query, y el texto de copyright, términos y privacidad es la única diferencia de contenido. Los detalles de referencia están en /compatibility/ip-api/. El código que lee response.city o response.isp directamente, sin desenvolver ningún objeto anidado, debería seguir funcionando una vez que cambien el host y la clave.

Lo que cambia concretamente en esta migración:

  • La autenticación pasa a una clave, enviada en una cabecera X-API-Key, con Authorization: Bearer, con autenticación HTTP Basic o en un parámetro de consulta, en lugar de una consulta pública sin autenticar o con límites ligeros
  • La cuota ahora es visible directamente en cada respuesta mediante cabeceras como X-Quota-Limit, X-Quota-Used y X-Quota-Reset, en lugar de tener que deducirla de limitaciones ocasionales
  • Los campos extra opcionales (detalles de amenazas de IP e información de red más detallada) están disponibles añadiendo mg_extras=1 o una cabecera X-MG-Extras, sin alterar la forma plana que tu código ya analiza

Hay 2.500 solicitudes gratuitas al día sin ninguna clave, y cada clave recibe además 2.500 solicitudes gratuitas al día contadas por red, ya sea IPv4 (por /24) o IPv6 (por /48), compartidas entre el uso sin clave y con clave desde esa red. Por encima de esa cuota, es crédito prepago a 0,0001 € por solicitud o una clave Unlimited por 50 € al mes, y todos los endpoints, incluido este host compatible, tienen el mismo precio.

Para aplicaciones que hacen redirecciones por país basadas en IP, comprobaciones de señales de fraude o enriquecimiento básico de analítica, esta suele ser una de las migraciones más sencillas de probar de principio a fin, ya que los resultados son concretos y se pueden comparar directamente con lo que devuelve la integración actual para el mismo conjunto de direcciones de prueba.

Más sobre migración