Documentação da API

Informações básicas da API

Para começar a usar a API do IPHunter, você deve assinar um Plano

Se inscrever

Na resposta da API, temos um campo chamado block , que identifica o nível de risco do IP analisado. Quando o block é igual a 1 , aconselhamos que o acesso do usuário analisado seja bloqueado para evitar problemas para o restante dos usuários que fazem um uso correto do site ou aplicativo.

block: 0  IP residencial / não classificado (IP seguro)

block: 1  IP não residencial (hospedagem, proxy, VPN ...)

block: 2  IP não residencial e residencial (aviso, pode alertar pessoas inocentes)

Todos os dias conhecemos mais de 3.000 novos IPS que são usados para ocultar a identidade real dos usuários (entre outros motivos).

Para mais informações, não hesite em consultar nossa documentação.

Documentação
informação adicional

Além do tipo de conexão com o nível de segurança ( block ), enviamos o nome do país em inglês, o código do país, a cidade e o ISP do IP.

Antes de bloquear um IP no seu site, recomendamos analisar se o usuário está tentando executar alguma ação fraudulenta no seu aplicativo. Lutamos contra a fraude na Internet e, em 90% dos casos, eles usam Hosting, VPN ou Proxy para ocultar a identificação dos usuários.

Resposta de amostra da API

Endpoint

curl https://www.iphunter.info:8082/v1/ip/148.56.53.217 -H "X-Key: PRIVATEAPIKEY"

Resposta correta

{
    "status": "success",
    "data": {
        "ip": "148.56.53.217",
        "ip_num": 2486711769,
        "country_code": "ES",
        "country_name": "Spain",
        "city": "Madrid",
        "isp": "Vodafone Espana S.A.U.",
        "block": 0
    }
}

Resposta a Erro

{
    "status": "error",
    "code": "Bad Ip Range"
}

A API responde no formato JSON. cURL é um programa de linha de comando para recuperar dados da web usando um console.

Se você atingir o limite de solicitações (por segundo ou por dia), um código de status HTTP 429 será retornado.