API
Samat tiedot kuin sivustolla, JSON-muodossa tai pelkkänä tekstinä. Ei avainta, ei tiliä; kohtuukäytön rajat ovat voimassa.
curl https://ipaddress.fi/api/v1/my-ip?format=textRajapinnat
| Polku | Kuvaus | Data | Käyttörajat |
|---|---|---|---|
| GET/api/v1/my-ipKokeile: /api/v1/my-ip | IP-osoitteesi (myös pelkkänä tekstinä parametrilla ?format=text). | Omat aineistot | 120 · 240/min |
| GET/api/v1/ip/{address}Kokeile: /api/v1/ip/1.1.1.1 | Osoitteen verkko-, reititys-, rekisteri- ja sijaintitiedot. | Omat aineistot | 30 · 30/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.fi/api/v1/bulk | Enintään 100 osoitetta kerralla (JSON {"addresses": […]} tai yksi riviä kohden), vastataan vain omista aineistoistamme. Mitään ei tallenneta. | Omat aineistot | 6 · 3/min |
| GET/api/v1/asn/{asn}Kokeile: /api/v1/asn/AS719 | Autonomisen järjestelmän haltija, rekisteri ja ilmoitetut prefiksit. | Omat aineistot | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXKokeile: /api/v1/dns/traficom.fi?type=A,MX | Verkkotunnuksen DNS-tietueet reaaliajassa. | Reaaliaikainen kysely | 40 · 60/min |
| GET/api/v1/rdap/{query}Kokeile: /api/v1/rdap/AS1741 | Rekisteröintitiedot vastuulliselta RDAP-palvelimelta. | Reaaliaikainen kysely | 10 · 6/min |
| GET/api/v1/healthKokeile: /api/v1/health | Palvelun toimintatila. | Omat aineistot | 120 · 240/min |
| GET/api/v1/data-statusKokeile: /api/v1/data-status | Jokaisen aineiston ikä ja koko. | Omat aineistot | 120 · 240/min |
Käyttörajat
Pyyntöjä rajoitetaan asiakasosoitteittain token bucket -menetelmällä. Kun raja täyttyy, rajapinta vastaa 429 ja Retry-After-otsakkeen. Rajat lasketaan muistissa tiivistetyllä, päivittäin vaihtuvalla avaimella; osoitteita ei tallenneta.
Virheet
Virheissä käytetään HTTP-tilakoodeja ja JSON-runkoa muodossa {"error": {"code": "…", "message": "…"}}.
Versiointi
Polkujen /api/v1/ vastausten rakenne säilyy. Uusia kenttiä voidaan lisätä; olemassa olevia ei poisteta eikä nimetä uudelleen v1:n sisällä.
Lähdemaininta
Sijaintitiedot tulevat DB-IP:ltä (CC BY 4.0). Jos näytät niitä, mainitse DB-IP lisenssin edellyttämällä tavalla.