Watch-IP

Schnellstart

Bringen Sie in wenigen Minuten einen funktionierenden GET /v1/geo-Aufruf zum Laufen: Erstellen Sie einen Schlüssel, stellen Sie eine Anfrage, und lesen Sie die Antwort.

Bevor Sie starten

  • Ein Watch-IP-Konto — der kostenlose Tarif reicht aus, um diesem Leitfaden zu folgen.
  • Eine Seite oder ein Skript, dem Sie einen fetch- oder curl-Aufruf hinzufügen können.

1. Ein Konto erstellen und einen Schlüssel holen

Registrieren Sie sich und öffnen Sie Ihr Dashboard. Jedes Konto startet mit einem veröffentlichbaren Besucher-Schlüssel — konfigurieren Sie dessen erlaubte Origins so, dass sie die Website enthalten, von der aus Sie ihn aufrufen werden (oder localhost während des Testens).

2. Ihre erste Anfrage stellen

Rufen Sie GET /v1/geo mit Ihrem veröffentlichbaren Schlüssel im X-Api-Key-Header auf. Aus einem Browser löst dies die eigene Verbindung des Besuchers auf; von einem Server aus löst es stattdessen die eigene Verbindung des Servers auf.

curl

curl https://api.watch-ip.com/v1/geo \
  -H "X-Api-Key: YOUR_PUBLISHABLE_KEY"

3. Die Antwort lesen

Ein erfolgreicher Aufruf liefert 200 mit einem JSON-Body — country, city und timezone sind die Felder, mit denen die meisten Integrationen beginnen, und jedes Feld ist unabhängig nullbar, prüfen Sie also, bevor Sie eines verwenden.

Antwort (gekürzt)

{
  "ip": "203.0.113.1",
  "country": "US",
  "city": "Austin",
  "timezone": "America/Chicago"
}

4. Eine andere IP abfragen

Müssen Sie eine bereits vorhandene Adresse auflösen, statt den verbindenden Besucher? Das ist ein separater Server-zu-Server-Endpoint, authentifiziert mit einem geheimen Schlüssel statt Ihrem veröffentlichbaren Schlüssel — siehe die IP-Abfrage-Referenz.

Wenn etwas schiefgeht

Ein 401 bedeutet, dass der API-Schlüssel fehlt oder ungültig ist; ein 403 von GET /v1/geo bedeutet meist, dass der aufrufende Origin noch nicht auf der Liste der erlaubten Origins des Schlüssels steht. Die vollständige Liste der Statuscodes finden Sie unter Fehler und Ratenbegrenzungen.

Nächster Schritt

Lesen Sie Authentifizierung, um zu erfahren, wie Schlüsseltypen und Origin-Bindung funktionieren, oder gehen Sie direkt zur Endpoint-Referenz für die Antwort, gegen die Sie integrieren.

Verwandte Seiten