La guida API GeoIPs

Il nostro API fornisce delle informazioni sull' IP utilizzando un'interfaccia REST che restituisce i dati seguenti:

  • hostname
  • proprietario
  • nome del continente, codice del continente
  • nome del paese, codice del paese
  • nome della regione, codice della regione
  • nome della provincia
  • nome della città
  • latitudine, longitudine
  • fuso orario
  • lingua ufficiale
  • moneta

Richiesta

Interrogare l'API GeoIPs è facile ed intuitivo. Fai la richiesta aggiungendo parametri validi per la query:

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

i parametri possono essere specificati in qualsiasi ordine all'interno del URL

Parametri

Parametri Necessario Valore predefinito Descrizione
ip no indirizzo IP del cliente indirizzo IP
key si vuoto chiave API fornita per l'applicazione registrata
output no xml specifica il formato per le risposte: xml, json, raw
timezone no false specifica il fuso orario per le risposte: true, false
hostname no false specifica il hostname per le risposte: true, false
language no false specifica la lingua ufficiale per le risposte: true, false
currency no false specifica la moneta per le risposte: true, false

Per ottenere una chiave API valida per la tua applicazione o il tuo sito web, ti preghiamo di registrare un account utente GeoIPs.

Risposta

Elemento Descrizione
ip indirizzo IP riferito
hostname hostname dell'indirizzo IP fornito
owner proprietario dell'indirizzo IP fornito
continent_name nome del continente
continent_code codice del continente
country_name nome del paese in base allo standard ISO-3166
country_code codice del paese a due lettere in base allo standard ISO-3166
region_name nome della regione
region_code codice della regione
county_name nome della provincia
city_name nome della città
latitude latitudine del luogo identificato, con i numeri positivi che rappresentano il Nord e negativi che rappresentano il Sud
longitude longitudine del luogo identificato con numeri positivi che rappresentano l'est e negativi che rappresentano l'ovest
timezone fuso orario

Per impostazione predefinita, l'API GeoIPs restituisce i messaggi nel formato XML strutturato. È inoltre possibile richiedere la risposta in formato JSON e testo semplice (RAW).

Campione di risposta 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>

Campione di risposta 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"
}
}
}

Campione di risposta 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

Codice Stato Messaggio Descrizione
200_1 Propper Request Success The following results has been returned.
200_2 Propper Request Not Found No result set has been returned.

Messaggi di errore

Se una richiesta ha esito negativo, l'API GeoIPs restituisce un messaggio di errore. Per impostazione predefinita, il messaggio viene restituito come XML strutturato, ma sono disponibili anche dei messaggi JSON e RAW.

<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>

Codice Stato Messaggio Descrizione
400_1 Bad Request Error in the URI The API call should include an 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.

Contatti

Contattaci

Vuoi saperne di più su GeoIPs e dei suoi servizi? Per ulteriori informazioni, ti preghiamo di contattarci utilizzando il seguente indirizzo di posta elettronica: .