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

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

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.