API de dirección IP y endpoints para la línea de comandos

curl checkmyip.com/raw
203.0.113.42

Para la mayoría de los usos, esa es toda la API: una petición, la dirección, un salto de línea. curl -4 y curl -6 fuerzan una familia; curl checkmyip.com/json devuelve los detalles de abajo. Cualquier cliente que envíe Accept: text/plain o un User-Agent de línea de comandos recibe la dirección a secas en /raw; los navegadores reciben la página normal.

Todos los endpoints responden por HTTPS con CORS habilitado para uso de solo lectura, envían Cache-Control: no-store y están marcados noindex para los buscadores. Los resultados de otras direcciones se guardan en caché diez minutos.

ip: la dirección como cadena. version: 4 o 6. geo.consensus: country (ISO 3166-1 alfa-2), region, city, lat, lon, timezone, confidence (0–1), disagreement (booleano), anycast (booleano); geo.sources[]: la respuesta de cada base de datos con updated, licence y attribution. network: asn, as_name, as_org, prefix, rir, allocation_date, registry_country, abuse_contacts[]. hostname: el nombre PTR o null. type.type: residential, mobile, business, datacenter o unknown, con confidence y reasons[]. risk: is_proxy, is_vpn, is_tor, is_datacenter, is_relay, score (0–100), level, reasons[], blacklists[] y score_version. Un valor ausente es null con el motivo en status o note; los veredictos heurísticos lo indican. Las cadenas de atribución deben mostrarse si enseñas los datos de geolocalización a tus usuarios (condiciones de CC BY 4.0 / CC BY-SA 4.0).

Cada ejemplo imprime la dirección pública de la máquina en la que se ejecuta.

#!/bin/sh
# avisar cuando cambie la IP pública (ejecutar desde cron cada 5 minutos)
new=$(curl -fsS --max-time 5 https://checkmyip.com/raw) || exit 0
old=$(cat /var/tmp/public-ip 2>/dev/null)
[ "$new" != "$old" ] && { echo "$new" > /var/tmp/public-ip; logger "public IP changed: $old -> $new"; }

Usa --max-time, trata un fallo como desconocido y no como cambio, y no consultes más de una vez por minuto.

/raw, /ip, /ip.txt, /json, /json?ip= y los hosts /ip de cada familia admiten 600 peticiones por minuto por dirección; el comprobador de puertos admite 20 por minuto y solo prueba la dirección de quien lo llama. Superar un límite devuelve HTTP 429 con un cuerpo de error en JSON. Los endpoints son gratuitos para uso personal, interno y comercial dentro de esos límites; si esperas un volumen sostenido por encima, o quieres incorporar nuestros datos en un producto, avísanos antes por la página de contacto. Por favor, no uses las páginas para personas desde scripts: son más pesadas y lentas que los endpoints de arriba.

Los endpoints corren en la misma red perimetral que el sitio y se monitorizan de forma continua; el endpoint /healthz de nuestro servidor de pruebas informa de su versión y su tiempo en marcha. Hay una página de estado pública en preparación. Los cambios en el formato de respuesta se anuncian en esta página con antelación; los campos existentes nunca se renombran, solo se añaden.