API-Dokumentation

Die öffentliche API prüft die IP-Adresse, von der die Anfrage kommt. Sie braucht kein Konto und keinen Schlüssel.

Endpunkt

GET https://ipcheck.astendo.io/api/v1/check

Ein Parameter für eine andere Adresse gibt es nicht. Ein Parameter format wird ignoriert.

Beispiel

curl https://ipcheck.astendo.io/api/v1/check

Antwort (200)

{
    "success": true,
    "timestamp": "2026-10-29T10:00:00Z",
    "ip": {
        "address": "203.0.113.7",
        "reverseDNS": "N/A",
        "geolocation": null
    },
    "blacklist": {
        "isBlacklisted": false,
        "matchType": "none",
        "matchedIP": null,
        "matchedRange": null,
        "source": null
    },
    "statistics": {
        "totalIPs": 123456,
        "totalRanges": 789,
        "lastUpdateUTC": "2026-10-29T03:00:00Z"
    }
}

Fehler

Fehler kommen als JSON mit dem Feld error, das einen code und eine message enthält.

Status	Code	Bedeutung
429	`rate_limited`	Zu viele Anfragen. Der Header `Retry-After` nennt die Wartezeit in Sekunden.
503	`unavailable`	Der Dienst oder die Blockliste ist gerade nicht erreichbar. Der Header `Retry-After` nennt die Wartezeit. Bei einem Ausfall wird nie als sauber gemeldet.

{
    "error": {
        "code": "rate_limited",
        "message": "Zu viele Anfragen. Bitte warten Sie 5 Sekunden."
    }
}

{
    "error": {
        "code": "unavailable",
        "message": "Die Blockliste ist gerade nicht erreichbar. Bitte versuchen Sie es später erneut."
    }
}

Rate Limit

Pro Absender-Adresse ist eine Abfrage alle 5 Sekunden erlaubt. IPv6-Adressen teilen sich das Limit pro /64-Netz.

Ältere Schnittstelle

Die Adresse /json und der Parameter ?format=json liefern dieselbe Erfolgsantwort. Ihre Fehlerantwort behält das bisherige Format mit success, einem Fehlertext in error und retry_after. Für neue Skripte nehmen Sie /api/v1/check.

Mehr als einen IP-Check nötig?

astendo betreut die IT von Unternehmen in Berlin und hält ihre Netze sauber.

Außerdem betreiben wir im Rechenzentrum Server für unsere Kunden, als Bare Metal oder virtualisiert, hochverfügbar und mit Firewall. Dazu kommen Managed Services wie Backup, E-Mail-Archivierung und hochverfügbares Webhosting.

Sprechen Sie uns an

Plattformen, die wir für unsere Kunden betreiben