API da 2IP
Informações gerais
Nossa API foi criada como um recurso público para obter as informações mais completas sobre o endereço IP do usuário. Os formatos de dados são XML ou JSON, com conexão HTTP/HTTPS. As informações nos bancos de dados são atualizadas diariamente, e qualquer webmaster pode integrar este serviço aos seus próprios projetos.
Nossa API
Para integrar nosso serviço aos seus projetos, oferecemos uma das seguintes APIs:
- serviço "Geo-IP API";
- serviço "Provider-IP API".
- serviço "Proxy-IP API".
- serviço "Hosting API";
- serviço "MAC-address API";
- serviço "Email API".
Restrições de uso
Cada um dos serviços Geo-IP API, Provider-IP API, Proxy-IP API, Hosting API, MAC-address API e Email API permite no máximo 2 solicitações gratuitas por endereço IP por dia.
Formato dos dados
Os dados fornecidos pela nossa API contêm os seguintes campos.
Serviço "Geo-IP API":
Serviço "Provider-IP API":
Serviço "Proxy-IP API":
Serviço "Hosting API":
Serviço "MAC-address API":
Serviço "Email API":
Exemplos de solicitações à API
Exemplo de solicitações XML e JSON ao serviço "Geo-IP API":
IPv4:
- XML: https://api.2ip.me/geo.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/geo.json?ip=45.140.147.155
IPv6:
- XML: https://api.2ip.me/geo.xml?ip=2001:4860:4860::8844
- JSON: https://api.2ip.me/geo.json?ip=2001:4860:4860::8844
Uma chamada à API com o parâmetro "ip" vazio retorna informações sobre o endereço IP de origem da solicitação.
Exemplo de solicitações XML e JSON ao serviço "Provider-IP API":
IPv4:
- XML: https://api.2ip.me/provider.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/provider.json?ip=45.140.147.155
Uma chamada à API com o parâmetro "ip" vazio retorna informações sobre o endereço IP de origem da solicitação.
Exemplo de solicitações XML e JSON ao serviço "Proxy-IP API":
IPv4:
- XML: https://api.2ip.me/proxy.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/proxy.json?ip=45.140.147.155
Uma chamada à API com o parâmetro "ip" vazio retorna informações sobre o endereço IP de origem da solicitação.
Exemplo de solicitações XML e JSON ao serviço "Hosting API":
Exemplo de solicitações XML e JSON ao serviço "MAC-address API":
- XML: https://api.2ip.me/mac.xml?mac=00:30:48:5a:58:65
- JSON: https://api.2ip.me/mac.json?mac=00:30:48:5a:58:65
O endereço MAC a ser verificado pode estar em um dos seguintes formatos:
- 00:30:48:5a:58:65
- 00-22-15-75-1C-1E
- 000a.e475.7469
- 001201BB4ADD
Exemplo de solicitações XML e JSON ao serviço "Email API":
Exemplos de respostas
Exemplo de resposta XML do serviço "Geo-IP API":
Exemplo de resposta JSON do serviço "Geo-IP API":
Exemplo de resposta XML do serviço "Provider-IP API":
Exemplo de resposta JSON do serviço "Provider-IP API":
Exemplo de resposta XML do serviço "Proxy-IP API":
Exemplo de resposta JSON do serviço "Proxy-IP API":
Exemplo de resposta XML do serviço "Hosting API":
Exemplo de resposta JSON do serviço "Hosting API":
Exemplo de resposta XML do serviço "MAC-address API":
Exemplo de resposta JSON do serviço "MAC-address API":
Exemplo de resposta XML do serviço "Email API":
Exemplo de resposta JSON do serviço "Email API":
Preço
Cada API aplicável permite 2 solicitações gratuitas por endereço IP por dia.
1000 solicitações por dia ao nosso banco de dados durante 30 dias custam 10$. Cada mil adicionais custam + 1$. Por exemplo, se você precisar de 5000 solicitações por dia, o custo será de 14$ por mês.
Número ilimitado de consultas — 100$ por mês (mas não mais de 1 milhão de chamadas por dia).
Após o pagamento, você receberá um e-mail com instruções e sua "API key" pessoal. O limite ficará vinculado a ela.
Você pode obter informações mais detalhadas enviando-nos uma solicitação ou entrar em contato pelo e-mail [email protected].