IP Checker Logo

Documentación de API y desarrolladores

Una API JSON pequeña y predecible. Los endpoints se proxyan a través de nuestra capa de abstracción de proveedores en el servidor, con normalización de respuestas, caché ligera y manejo de errores elegante.

Endpoints

GET /api/my-ip

Devuelve datos de geolocalización y red para la IP pública del emisor, tal como la ve el servidor.

curl https://ipcheck.mubarokah.com/api/my-ip

GET /api/lookup?q=<ip|domain>

Busque cualquier IPv4, IPv6 o dominio simple. Los esquemas (http/https) y rutas son rechazados.

curl "https://ipcheck.mubarokah.com/api/lookup?q=8.8.8.8"

POST /api/bulk

Búsquedas por lotes (hasta 50 por solicitud). La concurrencia está limitada en el servidor.

curl -X POST -H 'content-type: application/json' \
  -d '{"queries":["8.8.8.8","1.1.1.1","example.com"]}' \
  https://ipcheck.mubarokah.com/api/bulk

Forma de la respuesta

{
  "ok": true,
  "query": "8.8.8.8",
  "ip": "8.8.8.8",
  "ipVersion": "IPv4",
  "location": {
    "continent": "North America",
    "country": "United States",
    "countryCode": "US",
    "regionName": "Virginia",
    "city": "Ashburn",
    "zip": "20149",
    "lat": 39.0438,
    "lon": -77.4874,
    "timezone": "America/New_York",
    "utcOffsetSeconds": -14400,
    "currency": "USD"
  },
  "network": {
    "isp": "Google LLC",
    "org": "Google Public DNS",
    "as": "AS15169 Google LLC",
    "asname": "GOOGLE",
    "reverse": "dns.google"
  },
  "flags": { "mobile": false, "proxy": false, "hosting": true }
}

Errores

Límites de velocidad y caché

Las respuestas se almacenan en caché en el servidor durante 10 minutos por consulta. El nivel público gratuito del proveedor ascendente está limitado y destinado a un uso no comercial. Para tráfico de producción, recomendamos configurar un proveedor comercial a través de las variables de entorno documentadas a continuación.

Abstracción del proveedor

Configure las siguientes variables de entorno en el servidor. Los secretos nunca se exponen al navegador.

IP_PROVIDER=ip-api            # or ip-api-pro
IP_API_KEY=...                # required for pro
IP_API_BASE=http://ip-api.com

Notas