API
Dieselben Daten wie auf der Website, als JSON oder Klartext. Kein Schlüssel, kein Konto; faire Ratenlimits gelten.
curl https://ipaddress.pt/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.pt/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/AS3243 | Inhaber, Registry und angekündigte Präfixe eines autonomen Systems. | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/network/{cidr}Ausprobieren: /api/v1/network/193.136.0.0/15 | Ein Netz in CIDR-Notation: Größe, Bereich, Sonderzweck, wer es ankündigt (mit RPKI), die Registry-Delegation und eine Standortschätzung. | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/country/{cc}Ausprobieren: /api/v1/country/PT | Registrierter Adressraum und AS-Nummern eines Landes, was seine Netze ankündigen, RPKI-Abdeckung und die größten Netze (für PT auch die Schätzung pro Distrikt). | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/dns/{domain}?type=A,MXAusprobieren: /api/v1/dns/dns.pt?type=A,MX | Aktuelle DNS-Einträge einer Domain. | Live-Abfrage | 40 · 60/Min. |
| GET/api/v1/rdap/{query}Ausprobieren: /api/v1/rdap/AS3243 | 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. |
Klartext-Kurzformen außerhalb von /api/v1: /raw gibt Ihre Adresse aus, /json dasselbe Objekt wie /my-ip, /country den geschätzten Ländercode.
curl ipaddress.pt/rawcurl ipaddress.pt/jsoncurl ipaddress.pt/countryRatenlimits
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.