Le Guide API de GeoIPs

Notre API fournit des informations liées à l’IP en utilisant une interface REST qui renvoie les données suivantes:

  • hostname
  • propriétaire
  • nom du continent
  • nom du pays, code du pays
  • nom de la région, code de la région
  • nom du département
  • nom de la ville
  • latitude, longitude
  • fuseau horaire
  • langue officielle
  • monnaie

Demande

Appeler l’API de GeoIPs est facile et intuitif. Faites la demande en apposant des paramètres valides pour votre demande:

https://api.geoips.com/ip/«ip_address»/key/«api_key»/output/«format»/timezone/«bool»/hostname/«bool»/language/«bool»/currency/«bool»

les paramètres peuvent être spécifiés dans n'importe quel ordre à l'intérieur d'URL

Paramètres

Paramètre Requis Valeur par défaut Description
ip non adresse IP du client adresse IP
key oui vide clé api fournie pour l'application enregistrée
output non xml spécifie le format pour des réponses: xml, json, raw
timezone non false spécifie le fuseau horaire pour des réponses: true, false
hostname non false spécifie le hostname pour des réponses: true, false
language non false spécifie le langue officielle pour des réponses: true, false
currency non false spécifie le monnaie pour des réponses: true, false

Afin d'obtenir une clé valide d'api pour votre application ou site Web, veuillez créer un compted’utilisateur GeoIPs.

Réponse

Élément Description
ip adresse IP du client
hostname hostname de l’adresse IP fournie
owner propriétaire de l’adresse IP fournie
continent_name nom du continent
continent_code code du continent
country_name ISO-3166 nom du pays
country_code ISO-3166 code de pays à deux lettres
region_name nom de la région
region_code code de la région
county_name nom du département
city_name nom de la ville
latitude latitude de la localisation identifiée, avec des nombres positifs représentant le nord et des nombres négatifs représentant le sud
longitude longitude de la localisation identifiée, avec des nombres positifs représentant l’est et des nombres négatifs repésentant l’ouest
timezone fuseau horaire

Par défaut, l’API de GeoIPs envoie des réponses dans le format de données XML structuré. Vous pouvez également demander la réponse en format JSON ou texte simple (RAW).

Échantillon réponse XML

<response>
<status>Propper Request</status>
<message>Success</message>
<notes>The following results has been returned</notes>
<code>200_1</code>
<location>
<ip>8.8.8.8</ip>
<owner>LEVEL 3 COMMUNICATIONS INC</owner>
<continent_name>NORTH AMERICA</continent_name>
<continent_code>NA</continent_code>
<country_name>UNITED STATES</country_name>
<country_code>US</country_code>
<region_name>CALIFORNIA</region_name>
<region_code>CA</region_code>
<county_name>SANTA CLARA</county_name>
<city_name>MOUNTAIN VIEW</city_name>
<latitude>37.3801</latitude>
<longitude>-122.0865</longitude>
<timezone>PST</timezone>
</location>
<languages>
<language>
<alpha2_code>EN</alpha2_code>
<alpha3_code>ENG</alpha3_code>
<language_name>ENGLISH</language_name>
<native_name>ENGLISH</native_name>
</language>
</languages>
<currencies>
<currency>
<alpha_code>USD</alpha_code>
<numeric_code>840</numeric_code>
<currency_name>US DOLLAR</currency_name>
<currency_symbol>$</currency_symbol>
<fractional_unit>CENT</fractional_unit>
</currency>
</currencies>
<unit_test>
<elapsed_time>0.0609</elapsed_time>
<memory_usage>0.76MB</memory_usage>
</unit_test>
</response>

Échantillon réponse JSON

{
"response": {
"status": "Propper Request",
"message": "Success",
"notes": "The following results has been returned",
"code": "200_1",
"location": {
"ip": "8.8.8.8",
"owner": "LEVEL 3 COMMUNICATIONS INC",
"continent_name": "NORTH AMERICA",
"continent_code": "NA",
"country_name": "UNITED STATES",
"country_code": "US",
"region_name": "CALIFORNIA",
"region_code": "CA",
"county_name": "SANTA CLARA",
"city_name": "MOUNTAIN VIEW",
"latitude": "37.3801",
"longitude": "-122.0865",
"timezone": "PST"
},
"languages": {
"language": [
{
"alpha2_code": "EN",
"alpha3_code": "ENG",
"language_name": "ENGLISH",
"native_name": "ENGLISH"
}
]
},
"currencies": {
"currency": [
{
"alpha_code": "USD",
"numeric_code": "840",
"currency_name": "US DOLLAR",
"currency_symbol": "$",
"fractional_unit": "CENT"
}
]
},
"unit_test": {
"elapsed_time": "0.0609",
"memory_usage": "0.76MB"
}
}
}

Échantillon réponse RAW

Propper Request,Success,The following results has been returned,200_1, 8.8.8.8,LEVEL 3 COMMUNICATIONS INC,NORTH AMERICA,NA,UNITED STATES,US,CALIFORNIA,CA,SANTA CLARA,MOUNTAIN VIEW,37.3801,-122.0865,PST, languages,1,EN,ENG,ENGLISH,ENGLISH, currencies,1,USD,840,US DOLLAR,$,CENT, unit_test,0.609,0.76MB

Code Statut Message Description
200_1 Propper Request Success The following results has been returned.
200_2 Propper Request Not Found No result set has been returned.

Messages d’erreur

Si une demande échoue, l’API GeoIPs renvoie un message d'erreur. Par défaut, le message est retourné en tant que XML structuré, mais des messages JSON et RAW sont également disponibles.

<error>
<status>status</status>
<message>message</message>
<notes>notes</notes>
<code>code</code>
<unit_test>
<elapsed_time>time</elapsed_time>
<memory_usage>memory</memory_usage>
</unit_test>
</error>

Code Statut Message Description
400_1 Bad Request Error in the URI The API call should include a API key parameter.
400_2 Bad Request Error in the URI The API call should include a valid IP address.
403_1 Forbidden Not Authorized The API key associated with your request was not recognized.
403_2 Forbidden Account Inactive The API key has not been approved or has been disabled.
403_3 Forbidden Limit Exceeded The service you have requested is over capacity.

Contact

Demande de support

Demande de support

Vous avez un problème avec un de nos services ? Envoyez une demande de support à l’adresse e-mail et dites-nous comment nous pouvons vous aider.