Ip Lookup Docs | ApiBundle

Aperçu

Le service API Ip Lookup fournit une API simple et intuitive vous permettant de rechercher l'emplacement de n'importe quelle adresse IP

Faire une requête

Faire une requête est très simple: il suffit de fournir une adresse IP à rechercher et nous faisons le reste

https://api.apibundle.io/ip-lookup?apikey={yourapikey}&ip=12.51.23.2

Url

https://api.apibundle.io/ip-lookup

Méthode

GET

Paramètres de la requête

Paramètre	Type	Description
apikey requis	string	Votre clé api. Vous pouvez vous inscrire gratuitement ici si vous n'en avez pas encore
ip	ipv4 ou ipv6	Adresse IP que vous souhaitez requêter. NB: Si le paramètre n'est pas fourni, nous utiliserons l'adresse IP de la requête courante
language	string	TLa langue dans laquelle vous souhaitez que les détails du pays apparaissent. Les options possibles sont 'de', 'es', 'fr', 'ja', 'pt-BR', 'ru', 'zh-CN' ou 'en' La valeur par défaut est en

Paramètre

Type

Description

apikey requis

string

Votre clé api. Vous pouvez vous inscrire gratuitement ici si vous n'en avez pas encore

ipv4 ou ipv6

Adresse IP que vous souhaitez requêter.
NB: Si le paramètre n'est pas fourni, nous utiliserons l'adresse IP de la requête courante

language

string

TLa langue dans laquelle vous souhaitez que les détails du pays apparaissent. Les options possibles sont 'de', 'es', 'fr', 'ja', 'pt-BR', 'ru', 'zh-CN' ou 'en'

La valeur par défaut est en

Champs de réponse

Voici tous les champs retournés par l'api lorsque tout s'est bien passé (code 200)

Note: Tous ces champs sont nullables. Ceci est très utile pour les Ip réservés par exemple.

Champ	Type	Description
continent	object	Objet JSON contenant les détails du continent de l'adresse IP
continent->name	string	Nom du continent
continent->code	string	Code alpha 2 du continent
continent->geoname_id	number	Id du continent dans la base de données GeoNames
is_eu	boolean	Si l'adresse IP se trouve dans l'Union européenne
country	object	Objet JSON avec les détails du pays de l'adresse IP pays
country->name	string	Le nom du pays
country->iso_2_code	string	Le code alpha 2 du pays
country->iso_3_code	string	Le code alpha 3 du pays
country->flag_emoji	string	L'emoji du drapeau du pays
country->flag_unicode	string	Le drapeau du pays unicode
country->flag_image	string	L'image du drapeau du pays au format SVG. Exemple : https://apibundle.io/data/flags/irl.svg
country->calling_codes	string	Les codes d'appel du pays
country->geoname_id	number	Id du pays dans la base de données GeoNames
city	object	Objet JSON contenant les détails de la ville du pays de l'adresse IP
city->name	string	Nom de la ville
city->geoname_id	number	Id de la ville dans la base de données GeoNames
latitude	Float	La latitude de l'adresse IP
longitude	Float	La longitude de l'adresse IP
postal_code	string	Le code postal ou zip de l'adresse IP
timezone	object	Objet JSON contenant les détails du fuseau horaire où l'adresse IP est située
timezone->name	string	Le fuseau horaire de l'endroit où se trouve l'adresse IP. Exemple: Europe/Berlin
timezone->offset	number	Différence entre l'heure locale de l'IP et l'heure UTC en minutes. Notez qu'elle peut être négative
timezone->offset_name	string	Le nom humain long pour l'offset actuel de la zone, par exemple Gulf Standard Time ou Eastern Daylight Time
timezone->is_daylight_saving	boolean	Si l'adresse IP est en heure d'été ou d'hiver
timezone->current_time	string	L'heure actuelle dans le fuseau horaire de l'adresse IP. Exemple: 2022-06-27T08:05:42.153-05:00
currency	object	Objet JSON contenant les détails de la devise du pays de l'adresse IP
currency->name	string	Nom de la devise
currency->code	string	Code de la devise
currency->symbol	string	Symbole de la devise
connection	object	Objet JSON contenant les détails de la devise du pays de l'adresse IP
connection->asn	string	Le numéro de l'AS
connection->aso	string	Le nom de l'organisation de l'AS
ip	string	L'adresse IP donnée
type	string	Le type de l'adresse IP donnée. Les valeurs possibles sont ipv4 ou ipv6

Gestion des erreurs

En cas d'erreur, en plus de ce qui a été dit dans la section des erreurs communes à tous les apis, la seule erreur particulière que vous pourriez obtenir est la suivante:

Code HTTP	nom du type	nom du sous-type	nom du champ	Description
400	VALIDATION_ERROR	INVALID_IP	ip	Lorsque l'ip donné n'est pas syntaxiquement valide

Exemples

Vous trouverez ci-dessous quelques exemples de réponses. Vous pouvez souscrire à une clé api gratuite ici afin d'obtenir plus d'exemples une fois dans le tableau de bord.

Requête réussie avec un code HTTP de 200

{
  "ip": "12.51.23.2",
  "type": "ipv4",
  "continent": {
    "name": "North America",
    "code": "NA",
    "geoname_id": 6255149
  },
  "is_eu": false,
  "country": {
    "name": "United States",
    "iso_2_code": "US",
    "iso_3_code": "USA",
    "flag_emoji": "🇺🇸",
    "flag_unicode": "U+1F1FA U+1F1F8",
    "flag_image": "https://apibundle.io/data/flags/usa.svg",
    "calling_codes": [
      "1"
    ],
    "geoname_id": 6252001
  },
  "city": {
    "name": "Brookeland",
    "geoname_id": 4676539
  },
  "latitude": 31.0953,
  "longitude": -93.9664,
  "postal_code": "75931",
  "currency": {
    "code": "USD",
    "name": "United States dollar",
    "symbol": "$"
  },
  "timezone": {
    "name": "America/Chicago",
    "current_time": "2022-06-27T08:11:46.541-05:00",
    "offset": -300,
    "offset_name": "Central Daylight Time",
    "is_daylight_saving": true
  },
  "connection": {
    "asn": 7018,
    "aso": "ATT-INTERNET4"
  }
}

Échec de la requête avec un code HTTP 400

{
  "type": "VALIDATION_ERROR",
  "message": "Please provide a valid IP",
  "subtype": "INVALID_IP",
  "field": "ip"
}

Échec de la requête avec un code HTTP 401

{
  "type": "INVALID_API_KEY",
  "message": "Please provide a valid api key"
}

Docs du service API Ip Lookup