API
Dieselben Daten wie auf der Website, als JSON oder Klartext. Kein Schlüssel, kein Konto; faire Ratenlimits gelten.
curl https://ipaddress.se/api/v1/my-ip?format=textEndpunkte
| Pfad | Beschreibung | Daten | Ratenlimits |
|---|---|---|---|
| GET/api/v1/my-ipAusprobieren: /api/v1/my-ip | Ihre IP-Adresse (mit ?format=text auch als Klartext). | Eigene Datensätze | 120 · 240/Min. |
| GET/api/v1/ip/{address}Ausprobieren: /api/v1/ip/81.224.0.1 | Netz-, Routing-, Registry- und Standortdaten zu einer Adresse. | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/asn/{asn}Ausprobieren: /api/v1/asn/AS3301 | Inhaber, Registry und angekündigte Präfixe eines autonomen Systems. | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/dns/{domain}?type=A,MXAusprobieren: /api/v1/dns/internetstiftelsen.se?type=A,MX | Aktuelle DNS-Einträge einer Domain. | Live-Abfrage | 40 · 60/Min. |
| GET/api/v1/rdap/{query}Ausprobieren: /api/v1/rdap/AS3301 | Registrierungsdaten vom zuständigen RDAP-Server. | Live-Abfrage | 10 · 6/Min. |
| GET/api/v1/healthAusprobieren: /api/v1/health | Ob der Dienst läuft. | Eigene Datensätze | 120 · 240/Min. |
| GET/api/v1/data-statusAusprobieren: /api/v1/data-status | Alter und Größe jedes Datensatzes. | Eigene Datensätze | 120 · 240/Min. |
Ratenlimits
Anfragen werden pro Client-Adresse mit einem Token-Bucket begrenzt. Ist das Limit erreicht, antwortet die API mit 429 und einem Retry-After-Header. Gezählt wird im Arbeitsspeicher mit einem gehashten, täglich wechselnden Schlüssel; Adressen werden nicht gespeichert.
Fehler
Fehler nutzen HTTP-Statuscodes und einen JSON-Körper der Form {"error": {"code": "…", "message": "…"}}.
Versionierung
Pfade unter /api/v1/ behalten ihre Antwortstruktur. Neue Felder können hinzukommen; bestehende Felder werden innerhalb von v1 weder entfernt noch umbenannt.
Namensnennung
Standortdaten stammen von DB-IP (CC BY 4.0). Wenn Sie sie anzeigen, nennen Sie DB-IP, wie es die Lizenz verlangt.