Entwicklerdokumentation ReportedIP -API & Ökosystem

API v2

Authentifizierung

Die ReportedIP nutzt die Authentifizierung per API-Schlüssel, um Aufrufer zu identifizieren und Ratenbeschränkungen durchzusetzen. Einige öffentliche Endpunkte funktionieren ohne Authentifizierung, doch ein API-Schlüssel ermöglicht höhere Limits und zusätzliche Funktionen. Alle Endpunkte, Parameter und Code-Beispiele sind in der API-Referenz dokumentiert.

Authentifizierung über API-Schlüssel

Fügen Sie Ihren API-Schlüssel in jede authentifizierte Anfrage ein. Es gibt zwei Methoden – die X-Key Die Verwendung des Header-Tags wird empfohlen, da dadurch Ihr Schlüssel nicht in den Zugriffsprotokollen des Servers erscheint.

Methode 1: X-Key-Header (empfohlen)

curl -H "X-Key: YOUR_API_KEY" \
     "https://reportedip.de/wp-json/reportedip/v2/check?ip=1.2.3.4"

Methode 2: Abfrageparameter

curl "https://reportedip.de/wp-json/reportedip/v2/check?ip=1.2.3.4&key=YOUR_API_KEY"

Sicherheitshinweis: Vermeiden Sie die Verwendung von Abfrageparametern in der Produktionsumgebung. Abfragezeichenfolgen können von Webservern, Proxys und im Browserverlauf protokolliert werden. Verwenden Sie stattdessen die X-Key stattdessen die Kopfzeile.

So erhalten Sie Ihren API-Schlüssel

Befolgen Sie diese drei Schritte, um Ihren API-Schlüssel zu erhalten:

Konto erstellen

Registrieren Sie sich kostenlos unter reportedip.de/register und bestätigen Sie Ihre E-Mail-Adresse.

Öffnen Sie Ihr Dashboard

Navigieren Sie nach der Anmeldung zu Ihrem Dashboard.

API-Schlüssel generieren

Klicken Sie auf „API-Schlüssel generieren“, um Ihren Schlüssel zu erstellen. Kopieren Sie ihn sofort – er wird nur einmal angezeigt.

Benutzerrollen und Berechtigungen

Ihr API-Schlüssel ist an Ihre Benutzerrolle gebunden. Jede Rolle verfügt über unterschiedliche Ratenbegrenzungen und Zugriffsrechte auf Funktionen. Bei der Registrierung beginnen Sie mit der kostenlosen Rolle.

Rolle	Schecks / Tag	Berichte / Tag	Funktionen
`Public` (kein Schlüssel)	100 (pro IP)	—	Nur öffentliche Endpunkte (check-public, search-public, stats-public, categories, attack-map-data)
`Free`	1,000	50	Prüfen, melden, verifizieren
`Contributor`	5,000	200	Prüfen, melden, verifizieren
`Professional`	25,000	1,000	+ Massenprüfung, Trends, Berichte
`Business`	100.000 (pro Lizenz)	5.000 (pro Lizenz)	+ Audit-Trail, White-Label; die Kontingente skalieren mit der Anzahl der Lizenzen (x2–x20)
`Enterprise`	Unbegrenzt	Unbegrenzt	+ Massenbericht, benutzerdefinierte AVV/DPA
`Honeypot`	Unbegrenzt	Unbegrenzt	Automatisierte Systeme

Ratenbegrenzungen

Jede API-Antwort enthält Header zur Ratenbegrenzung, sodass Sie Ihre Nutzung in Echtzeit verfolgen können. Wenn Sie Ihr Limit überschreiten, antwortet die API mit 429 Too Many Requests.

Kopfzeile	Beschreibung
`X-RateLimit-Limit`	Maximal zulässige Anzahl von Anfragen pro Tag
`X-RateLimit-Remaining`	Im aktuellen Fenster verbleibende Anfragen
`X-RateLimit-Reset`	Zeitstempel (UTC-Epoche) zum Zeitpunkt der Zurücksetzung des Limits
`Retry-After`	Sekunden Wartezeit vor einem erneuten Versuch (nur bei 429-Antworten)

Beispiel für Antwort-Header

HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 742
X-RateLimit-Reset: 1711929600
Content-Type: application/json; charset=UTF-8

Hybride Authentifizierung

Öffentliche Endpunkte wie /check-public, /search-publicund /stats-public funktionieren ohne jegliche Authentifizierung. Sie akzeptieren jedoch einen optionalen API-Schlüssel, um höhere Ratenbegrenzungen freizuschalten.

# Without API key — 100 requests/day per IP
curl "https://reportedip.de/wp-json/reportedip/v2/check-public?ip=1.2.3.4"

# With API key — uses your role's daily limit
curl -H "X-Key: YOUR_API_KEY" \
     "https://reportedip.de/wp-json/reportedip/v2/check-public?ip=1.2.3.4"

Tipp: Wenn Sie nur einfache Abfragen benötigen und weniger als 100 Anfragen pro Tag stellen, können Sie die Authentifizierung ganz überspringen, indem Sie die öffentlichen Endpunkte nutzen.

Fehlermeldungen

Bei Authentifizierungsfehlern werden Standard-JSON-Antworten zurückgegeben. Überprüfen Sie dies stets meta.success und den HTTP-Statuscode.

401 Nicht autorisiert

Wird zurückgegeben, wenn der API-Schlüssel fehlt oder ungültig ist.

401 Nicht autorisiert

{
  "meta": {
    "success": false,
    "code": 401,
    "message": "Invalid or missing API key."
  },
  "data": null
}

403 Zugriff verweigert

Wird zurückgegeben, wenn Ihre Rolle keine Berechtigung für den angeforderten Endpunkt hat.

403 Zugriff verweigert

{
  "meta": {
    "success": false,
    "code": 403,
    "message": "Your role does not have access to this endpoint."
  },
  "data": null
}

429 Zu viele Anfragen

Wird zurückgegeben, wenn Sie Ihr tägliches Limit überschritten haben.

429 Zu viele Anfragen

{
  "meta": {
    "success": false,
    "code": 429,
    "message": "Rate limit exceeded. Try again later."
  },
  "data": {
    "retryAfter": 3600
  }
}

Bewährte Verfahren

Cache-Antworten

IP-Reputationen ändern sich nicht im Sekundentakt. Speichern Sie die Ergebnisse der Überprüfung mindestens 15 Minuten lang im Cache, um die Anzahl der API-Aufrufe zu reduzieren und Ihr Ratenlimit einzuhalten.

Exponentiellen Backoff verwenden

Wenn Sie eine 429 Antwort, warte die in der Retry-After Kopfzeile. Versuchen Sie es nicht sofort erneut.

Wähle die richtige Rolle

Beginnen Sie mit dem kostenlosen Tarif. Wenn Sie Massenvorgänge oder höhere Limits benötigen, wechseln Sie zu „Professional“, Business oder „Enterprise“ – einen vollständigen Vergleich finden Sie auf der Seite „Preise “.

Behalte deinen Schlüssel geheim

Geben Sie Ihren API-Schlüssel niemals in clientseitigem Code, öffentlichen Repositorys oder URLs preis. Verwenden Sie Umgebungsvariablen und die X-Key Kopfzeile.

Zuletzt aktualisiert: 22. Juli 2026 · Betreut vom ReportedIP

Sicherheitsorientiert

DSGVO-konform

Hergestellt in Deutschland

Zurück zu Docs