Para desenvolvedores
Visão geral da API
Como a API HTTP funciona: endereço, formato das respostas e boas práticas.
A API do Meu IP é HTTP puro. Cada ferramenta do site tem uma rota GET que você pode chamar de qualquer linguagem, script ou automação.
Endereço base
https://meuip.juk.re/api
Não precisa de chave de API nem de cadastro.
Formato
- Todas as rotas usam GET, com os parâmetros na query string.
- As respostas são JSON, exceto o ping (texto em tempo real) e /api/ip?format=text (texto puro).
- Os erros trazem um campo error com a explicação.
Idioma das mensagens
Mande o cabeçalho x-lang (pt, en, es ou fr) ou Accept-Language para receber as mensagens de erro no idioma que preferir.
Boas práticas
- Guarde em cache o que muda pouco, como DNS e WHOIS.
- Quando receber 429, espere o tempo do cabeçalho Retry-After antes de tentar de novo.
- Defina um timeout no seu cliente: algumas consultas dependem do servidor de destino.
- Identifique o seu serviço com um User-Agent próprio.
Na página Developers você vê exemplos em 8 linguagens e pode executar cada chamada na hora.