API
De samme data som webstedet, som JSON eller ren tekst. Ingen nøgle, ingen konto; rimelige forbrugsgrænser gælder.
curl https://ipaddress.no/api/v1/my-ip?format=textEndepunkter
| Sti | Beskrivelse | Data | Forbrugsgrænser |
|---|---|---|---|
| GET/api/v1/my-ipPrøv: /api/v1/my-ip | Din IP-adresse (også som ren tekst med ?format=text). | Egne datasæt | 120 · 240/min |
| GET/api/v1/ip/{address}Prøv: /api/v1/ip/1.1.1.1 | Netværks-, routing-, register- og placeringsdata for en adresse. | Egne datasæt | 30 · 30/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.no/api/v1/bulk | Op til 100 adresser på én gang (JSON {"addresses": […]} eller én pr. linje), besvaret udelukkende fra vores egne datasæt. Intet gemmes. | Egne datasæt | 6 · 3/min |
| GET/api/v1/asn/{asn}Prøv: /api/v1/asn/AS719 | Indehaver, register og annoncerede præfikser for et autonomt system. | Egne datasæt | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXPrøv: /api/v1/dns/norid.no?type=A,MX | DNS-poster for et domæne, hentet live. | Live forespørgsel | 40 · 60/min |
| GET/api/v1/rdap/{query}Prøv: /api/v1/rdap/AS1741 | Registreringsdata fra den autoritative RDAP-server. | Live forespørgsel | 10 · 6/min |
| GET/api/v1/healthPrøv: /api/v1/health | Om tjenesten kører. | Egne datasæt | 120 · 240/min |
| GET/api/v1/data-statusPrøv: /api/v1/data-status | Alder og størrelse på hvert datasæt. | Egne datasæt | 120 · 240/min |
Forbrugsgrænser
Forespørgsler begrænses pr. klientadresse med en token bucket. Når grænsen er nået, svarer API'et med 429 og en Retry-After-header. Grænserne tælles i hukommelsen med en hashet nøgle, der skiftes dagligt; adresser gemmes ikke.
Fejl
Fejl bruger HTTP-statuskoder og en JSON-krop på formen {"error": {"code": "…", "message": "…"}}.
Versionering
Stier under /api/v1/ beholder deres svarformat. Nye felter kan blive tilføjet; eksisterende felter fjernes eller omdøbes ikke inden for v1.
Kildeangivelse
Placeringsdata kommer fra DB-IP (CC BY 4.0). Hvis du viser dem, skal du kreditere DB-IP, som licensen kræver.