API
De samme dataene som nettstedet, som JSON eller ren tekst. Ingen nøkkel, ingen konto; rimelige bruksgrenser gjelder.
curl https://ipaddress.no/api/v1/my-ip?format=textEndepunkter
| Sti | Beskrivelse | Data | Bruksgrenser |
|---|---|---|---|
| GET/api/v1/my-ipPrøv: /api/v1/my-ip | IP-adressen din (også som ren tekst med ?format=text). | Egne datasett | 120 · 240/min |
| GET/api/v1/ip/{address}Prøv: /api/v1/ip/1.1.1.1 | Nettverks-, ruting-, register- og lokasjonsdata for en adresse. | Egne datasett | 30 · 30/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.no/api/v1/bulk | Opptil 100 adresser på én gang (JSON {"addresses": […]} eller én per linje), besvart bare fra våre egne datasett. Ingenting lagres. | Egne datasett | 6 · 3/min |
| GET/api/v1/asn/{asn}Prøv: /api/v1/asn/AS719 | Innehaver, register og annonserte prefikser for et autonomt system. | Egne datasett | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXPrøv: /api/v1/dns/norid.no?type=A,MX | DNS-poster for et domene, hentet direkte. | Direkte spørring | 40 · 60/min |
| GET/api/v1/rdap/{query}Prøv: /api/v1/rdap/AS1741 | Registreringsdata fra den autoritative RDAP-serveren. | Direkte spørring | 10 · 6/min |
| GET/api/v1/healthPrøv: /api/v1/health | Om tjenesten er oppe. | Egne datasett | 120 · 240/min |
| GET/api/v1/data-statusPrøv: /api/v1/data-status | Alder og størrelse på hvert datasett. | Egne datasett | 120 · 240/min |
Bruksgrenser
Forespørsler begrenses per klientadresse med en token bucket. Når grensen er nådd, svarer API-et med 429 og en Retry-After-header. Grensene telles i minnet med en hashet nøkkel som byttes daglig; adresser lagres ikke.
Feil
Feil bruker HTTP-statuskoder og en JSON-kropp på formen {"error": {"code": "…", "message": "…"}}.
Versjonering
Stier under /api/v1/ beholder svarformatet. Nye felt kan bli lagt til; eksisterende felt fjernes eller endrer ikke navn innenfor v1.
Kildeangivelse
Lokasjonsdata kommer fra DB-IP (CC BY 4.0). Hvis du viser dem, må du kreditere DB-IP slik lisensen krever.