API
Dieselben Daten wie auf der Website, als JSON oder Klartext. Kein Schlüssel, kein Konto; faire Ratenlimits gelten.
curl https://ipaddress.co.il/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/132.247.0.1 | Netz-, Routing-, Registry- und Standortdaten zu einer Adresse. | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/ip/geolocation?ip=Ausprobieren: /api/v1/ip/geolocation?ip=177.224.0.1 | Nur die geschätzte Position einer Adresse (DB-IP Lite), stets als Schätzung gekennzeichnet. | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/ip/asn?ip=Ausprobieren: /api/v1/ip/asn?ip=2001:1208::1 | Ursprungs-AS und angekündigtes Präfix einer Adresse sowie die Registry-Delegation, in der sie liegt. | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/ip/reverse?ip=Ausprobieren: /api/v1/ip/reverse?ip=8.8.8.8 | Der PTR-Eintrag einer öffentlichen Adresse, live, mit Vorwärtsbestätigung. | Live-Abfrage | 40 · 60/Min. |
| GET/api/v1/ip/blacklist?ip=Ausprobieren: /api/v1/ip/blacklist?ip=8.8.8.8 | Live-DNSBL-Ergebnisse (SpamCop, PSBL, DroneBL, s5h.net) und das Tor-Exit-Kennzeichen einer öffentlichen Adresse. | Live-Abfrage | 40 · 60/Min. |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.co.il/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/AS8151 | 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/132.247.0.0/16 | 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/network/ipv4?cidr=Ausprobieren: /api/v1/network/ipv4?cidr=192.168.1.37/24 | Subnetzrechnung für ein IPv4- oder IPv6-Netz: Netz, Broadcast, Masken, nutzbarer Bereich und Anzahlen. | Eigene Datensätze | 120 · 240/Min. |
| GET/api/v1/network/ipv6?cidr=Ausprobieren: /api/v1/network/ipv6?cidr=2001:db8::/48 | Subnetzrechnung für ein IPv4- oder IPv6-Netz: Netz, Broadcast, Masken, nutzbarer Bereich und Anzahlen. | Eigene Datensätze | 120 · 240/Min. |
| GET/api/v1/country/{cc}Ausprobieren: /api/v1/country/MX | Registrierter Adressraum und AS-Nummern eines Landes, was seine Netze ankündigen, RPKI-Abdeckung und die größten Netze (für IL auch die Schätzung je Bezirk). | Eigene Datensätze | 30 · 30/Min. |
| GET/api/v1/dns/{domain}?type=A,MXAusprobieren: /api/v1/dns/unam.mx?type=A,MX | Aktuelle DNS-Einträge einer Domain. | Live-Abfrage | 40 · 60/Min. |
| GET/api/v1/dns/propagation?name=&type=Ausprobieren: /api/v1/dns/propagation?name=unam.mx&type=A | Dieselbe DNS-Frage an mehrere öffentliche Resolver, mit jeder Antwort und ob sie übereinstimmen. | Live-Abfrage | 40 · 60/Min. |
| GET/api/v1/rdap/{query}Ausprobieren: /api/v1/rdap/AS8151 | 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.
Jeder Pfad-Endpunkt hat auch eine Form mit Parametern: /ip/lookup?ip=, /asn/lookup?asn=, /dns/lookup?name=, /network/cidr?cidr=. Jede Antwort trägt einen X-Request-Id-Header.
curl ipaddress.co.il/rawcurl ipaddress.co.il/jsoncurl ipaddress.co.il/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.