iplocate API Handbuch
Unser API bietet IP Daten anhand einer REST Interface die folgende Informationen anbietet:
- Hostname
- Besitzer
- Kontinent, Kontinentkürzel
- Land, Landestkürzel
- Region, Regionkürzel
- Staat
- Stadt
- Geographische Breite, Geographische Länge
- Zeitzone
- Offizielle Sprache
- Währung
Anfrage
Der Anruf der iplocate API ist einfach und intuitiv. Um eine Anfrage zu machen, hängen Sie die gültige Parameter für Ihre Anfrage:
https://api.iplocate.com/ip/«ip_address»/key/«api_key»/output/«format»/timezone/«bool»/hostname/«bool»/language/«bool»/currency/«bool»
Die Parameter können in irgendeine Reihenfolge in die URL angegeben sein
Parameter
Parameter | Notwendig | Vorgegebenen Wert | Beschreibung |
---|---|---|---|
ip | nein | Kunden IP Adresse | IP Adresse |
key | ja | null | API Schlüssel angegeben für angemeldete Applikationen |
output | nein | xml | zeigt der Format der Antwort: xml, json, raw |
timezone | nein | false | zeigt die Zeitzone der Antwort: true, false |
hostname | nein | false | zeigt der Hostname der Antwort: true, false |
language | nein | false | zeigt die offizielle Sprache der Antwort: true, false |
currency | nein | false | zeigt die Währung der Antwort: true, false |
Um ein gültiges API Schlüssel für Ihre Applikation oder Website zu erhalten, bittemelden Sie sich für iplocate Benutzerkonto an.
Antwort
Element | Beschreibung |
---|---|
ip | eingetragene IP Adresse |
hostname | Hostname der eingetragene IP Adresse |
owner | Besitzer der eingetragene IP Adresse |
continent_name | Kontinent |
continent_code | Kontinentkürzel |
country_name | ISO-3166 Name des Landes |
country_code | ISO-3166 zweibuchstabigen Länderkürzel |
region_name | Name der Region |
region_code | Regionkürzel |
county_name | Name des Staates |
city_name | Name der Stadt |
latitude | geographische Breite der identifizierte Lokation, wo positive Zahlen der Norden und negative Zahlen der Süden anzeigen |
longitude | geographische Länge der identifizierte Lokation, wo positive Zahlen der Osten und negative Zahlen der Westen anzeigen |
timezone | Zeitzone |
Standardmäßig, iplocate API bietet Antworten in der Form von strukturierten XML an. Sie können aber auch Ijr Antwort in JSON oder Klartext (RAW) erhalten.
Muster XML Antwort
<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>
Muster JSON Antwort
{ "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" } } }
Muster RAW Antwort
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 | Status | Meldung | Beschreibung |
---|---|---|---|
200_1 | Propper Request | Success | The following results has been returned. |
200_2 | Propper Request | Not Found | No result set has been returned. |
Fehlermeldung
Falls die Anfrage nicht erfolgreich ist, der iplocate API zeigt eine Fehlermeldung. Standardmäßig, diese Meldung ist in der Form strukturierten XML, aber JSON und RAW Meldungen sind auch vorhanden.
<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 | Status | Meldung | Beschreibung |
---|---|---|---|
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. |
Kontakt
Support-Anfrage
Haben Sie Probleme mit einer unseren Services? Schicken Sie eine Support-Anfrage an und teilen Sie mit wie wir Ihnen helfen können.