Documentation API

Informations de base sur l'API

Pour commencer à utiliser l'API IPHunter, vous devez vous abonner à un plan

Souscrire

Dans la réponse de l'API, nous avons un champ appelé block , qui identifie le niveau de risque de l'adresse IP analysée. Lorsque le block est égal à 1, nous conseillons que l'accès de l'utilisateur analysé soit bloqué pour éviter des problèmes aux autres utilisateurs qui font une utilisation correcte de leur site Web ou de leur application.

block: 0 IP résidentielle / non classée (IP sécurisée)

block: 1 IP non résidentielle (Hébergement, Proxy, VPN ...)

block: 2 IP non résidentielle et résidentielle (avertissement, peut alerter des personnes innocentes)

Chaque jour, nous connaissons plus de 3000 nouveaux IPS qui sont utilisés pour cacher la véritable identité des utilisateurs (entre autres raisons).

Pour plus d'informations, n'hésitez pas à consulter notre documentation.

Documentation

Information additionnelle

En plus du type de connexion avec niveau de sécurité ( block ), nous envoyons le nom du pays en anglais, le code du pays, la ville et le FAI de l'IP.

Avant de bloquer une adresse IP sur votre site, nous vous recommandons d'analyser si l'utilisateur tente d'effectuer une action frauduleuse sur votre application. Nous luttons contre la fraude sur Internet et dans 90% des cas, ils utilisent l' hébergement, le VPN ou le proxy pour masquer l'identification des utilisateurs.

Exemple de réponse d'API

Endpoint

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

Bonne réponse

{
    "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
    }
}

Réponse d'erreur

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

L'API répond au format JSON. cURL est un programme en ligne de commande pour récupérer des données à partir du Web à l'aide d'une console.

Si vous atteignez la limite de demandes (par seconde ou par jour), un code d'état HTTP de 429 sera retourné.