API de endereço IP e endpoints de linha de comando

curl checkmyip.com/raw
203.0.113.42

Essa é a API inteira para a maioria dos usos: uma requisição, o endereço, uma quebra de linha. curl -4 e curl -6 forçam uma família; curl checkmyip.com/json retorna os detalhes abaixo. Qualquer cliente que envie Accept: text/plain ou um User-Agent de linha de comando recebe o endereço puro em /raw; os navegadores recebem a página para humanos.

Todos os endpoints respondem por HTTPS com CORS ativado para uso somente leitura, enviam Cache-Control: no-store e são marcados como noindex para os mecanismos de busca. Os resultados para outros endereços ficam em cache por dez minutos.

ip — o endereço como string. version — 4 ou 6. geo.consensus — country (ISO 3166-1 alpha-2), region, city, lat, lon, timezone, confidence (0–1), disagreement (booleano), anycast (booleano); geo.sources[] — a resposta de cada base com updated, licence e attribution. network — asn, as_name, as_org, prefix, rir, allocation_date, registry_country, abuse_contacts[]. hostname — o nome PTR ou null. type.type — residential, mobile, business, datacenter ou unknown, com confidence e reasons[]. risk — is_proxy, is_vpn, is_tor, is_datacenter, is_relay, score (0–100), level, reasons[], blacklists[] e score_version. Um valor ausente é null, com o motivo em status ou note; vereditos heurísticos dizem que são heurísticos. As strings de atribuição precisam ser exibidas se você mostrar os dados de geolocalização aos usuários (condições das licenças CC BY 4.0 / CC BY-SA 4.0).

Cada exemplo imprime o endereço público da máquina em que roda.

#!/bin/sh
# avisa quando o IP público muda (rode pelo cron a 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"; }

Use --max-time, trate uma falha como desconhecido, e não como mudou, e não consulte mais do que uma vez por minuto.

/raw, /ip, /ip.txt, /json, /json?ip= e os hosts /ip de família específica permitem 600 requisições por minuto por endereço; o teste de portas permite 20 por minuto e só testa o próprio endereço de quem chama. Exceder um limite retorna HTTP 429 com um corpo de erro em JSON. Os endpoints são gratuitos para uso pessoal, interno e comercial dentro desses limites; se você espera um volume sustentado acima deles, ou quer incorporar os nossos dados em um produto, avise antes pela página de contato. Por favor, não use as páginas para humanos a partir de scripts — elas são mais pesadas e mais lentas do que os endpoints acima.

Os endpoints rodam na mesma rede de borda do site e são monitorados continuamente; o endpoint /healthz do nosso servidor de teste informa a versão e o tempo de atividade dele. Uma página pública de status está planejada. Mudanças no formato da resposta são anunciadas nesta página com antecedência; campos existentes nunca são renomeados, apenas adicionados.