API
Dei same dataa som nettstaden, som JSON eller rein tekst. Ingen nøkkel, ingen konto; rimelege bruksgrenser gjeld.
curl https://ipaddress.no/api/v1/my-ip?format=textEndepunkt
| Sti | Skildring | Data | Bruksgrenser |
|---|---|---|---|
| GET/api/v1/my-ipPrøv: /api/v1/my-ip | IP-adressa di (òg som rein tekst med ?format=text). | Eigne datasett | 120 · 240/min |
| GET/api/v1/ip/{address}Prøv: /api/v1/ip/1.1.1.1 | Nettverks-, ruting-, register- og lokasjonsdata for ei adresse. | Eigne 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å éin gong (JSON {"addresses": […]} eller éi per linje), svara berre frå våre eigne datasett. Ingenting blir lagra. | Eigne datasett | 6 · 3/min |
| GET/api/v1/asn/{asn}Prøv: /api/v1/asn/AS719 | Innehavar, register og annonserte prefiks for eit autonomt system. | Eigne datasett | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXPrøv: /api/v1/dns/norid.no?type=A,MX | DNS-postar for eit domene, henta direkte. | Direkte spørjing | 40 · 60/min |
| GET/api/v1/rdap/{query}Prøv: /api/v1/rdap/AS1741 | Registreringsdata frå den autoritative RDAP-tenaren. | Direkte spørjing | 10 · 6/min |
| GET/api/v1/healthPrøv: /api/v1/health | Om tenesta er oppe. | Eigne datasett | 120 · 240/min |
| GET/api/v1/data-statusPrøv: /api/v1/data-status | Alder og storleik på kvart datasett. | Eigne datasett | 120 · 240/min |
Bruksgrenser
Førespurnader blir avgrensa per klientadresse med ein token bucket. Når grensa er nådd, svarar API-et med 429 og ein Retry-After-header. Grensene blir talde i minnet med ein hasha nøkkel som blir bytt dagleg; adresser blir ikkje lagra.
Feil
Feil brukar HTTP-statuskodar og ein JSON-kropp på forma {"error": {"code": "…", "message": "…"}}.
Versjonering
Stiar under /api/v1/ held på svarformatet. Nye felt kan bli lagde til; eksisterande felt blir ikkje fjerna eller får nytt namn innanfor v1.
Kjeldetilvising
Lokasjonsdata kjem frå DB-IP (CC BY 4.0). Om du viser dei, må du kreditere DB-IP slik lisensen krev.