API
Os mesmos dados do site, em JSON ou texto simples. Sem chave, sem conta; aplicam-se limites de utilização razoável.
curl https://ipaddress.fi/api/v1/my-ip?format=textEndpoints
| Caminho | Descrição | Dados | Limites de pedidos |
|---|---|---|---|
| GET/api/v1/my-ipExperimentar: /api/v1/my-ip | O seu endereço IP (também em texto simples com ?format=text). | Dados próprios | 120 · 240/min |
| GET/api/v1/ip/{address}Experimentar: /api/v1/ip/1.1.1.1 | Dados de rede, encaminhamento, registo e localização de um endereço. | Dados próprios | 30 · 30/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.fi/api/v1/bulk | Até 100 endereços de uma vez (JSON {"addresses": […]} ou um por linha), respondidos apenas a partir dos nossos próprios dados. Nada é guardado. | Dados próprios | 6 · 3/min |
| GET/api/v1/asn/{asn}Experimentar: /api/v1/asn/AS719 | Titular, registo e prefixos anunciados de um sistema autónomo. | Dados próprios | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXExperimentar: /api/v1/dns/traficom.fi?type=A,MX | Registos DNS em direto de um domínio. | Consulta em direto | 40 · 60/min |
| GET/api/v1/rdap/{query}Experimentar: /api/v1/rdap/AS1741 | Dados de registo do servidor RDAP responsável. | Consulta em direto | 10 · 6/min |
| GET/api/v1/healthExperimentar: /api/v1/health | Estado de funcionamento do serviço. | Dados próprios | 120 · 240/min |
| GET/api/v1/data-statusExperimentar: /api/v1/data-status | Idade e tamanho de cada conjunto de dados. | Dados próprios | 120 · 240/min |
Limites de pedidos
Os pedidos são limitados por endereço de cliente com um token bucket. Quando o limite é atingido, a API responde 429 com um cabeçalho Retry-After. Os limites são contados em memória com uma chave cifrada que muda diariamente; os endereços não são guardados.
Erros
Os erros usam códigos de estado HTTP e um corpo JSON da forma {"error": {"code": "…", "message": "…"}}.
Versões
Os caminhos em /api/v1/ mantêm a forma das respostas. Podem ser acrescentados campos novos; os existentes não são removidos nem renomeados na v1.
Atribuição
Os dados de localização vêm da DB-IP (CC BY 4.0). Se os mostrar, credite a DB-IP como exige a licença.