ipstack

Important Notice We have teamed up with ipstack.com to offer an even better IP Intelligence API.
To continue using the free iplocate service, please click the button on the rightbelow.Keep using the Free API

La guida API iplocate

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 iplocate è facile ed intuitivo. Fai la richiesta aggiungendo parametri validi per la query:

https://api.iplocate.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 iplocate.

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

Aggiornamento e correzione

Hai dei suggerimenti per l'aggiornamento o la correzione dei nostri servizi? Facci sapere utilizzando l'indirizzo di posta elettronica e ti contatteremo nei prossimi giorni.