GeoIPs 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 GeoIPs API ist einfach und intuitiv. Um eine Anfrage zu machen, hängen Sie die gültige Parameter für Ihre Anfrage:

https://api.geoips.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 GeoIPs 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, GeoIPs 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 GeoIPs 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

Update & Verbesserung

Haben Sie einen Vorschlag betreffend Updates oder Verbesserungen? Teilen Sie es mit unter der Email Adresse und wir werden uns an Ihnen in ein paar Tagen wenden.