API
Dieselben Daten wie auf der Website, als JSON oder Klartext. Kein Schlüssel, kein Konto; faire Ratenlimits gelten.
curl https://ipaddress.fi/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/1.1.1.1 | Netz-, Routing-, Registry- und Standortdaten zu einer Adresse. | Eigene Datensätze | 30 · 30/Min. |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.fi/api/v1/bulk | Bis zu 100 Adressen auf einmal (JSON {"addresses": […]} oder eine pro Zeile), nur aus unseren eigenen Datensätzen beantwortet. Nichts wird gespeichert. | Eigene Datensätze | 6 · 3/Min. |
| GET/api/v1/asn/{asn}Ausprobieren: /api/v1/asn/AS719 | 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/traficom.fi?type=A,MX | Aktuelle DNS-Einträge einer Domain. | Live-Abfrage | 40 · 60/Min. |
| GET/api/v1/rdap/{query}Ausprobieren: /api/v1/rdap/AS1741 | 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.