API
Samat tiedot kuin sivustolla, JSON-muodossa tai pelkkänä tekstinä. Ei avainta, ei tiliä; kohtuukäytön rajat ovat voimassa.
curl https://ipaddress.ee/api/v1/my-ip?format=textRajapinnat
| Polku | Kuvaus | Tiedot | 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/144.122.145.153 | Osoitteen verkko-, reititys-, rekisteri- ja sijaintitiedot. | Omat aineistot | 30 · 30/min |
| GET/api/v1/ip/geolocation?ip=Kokeile: /api/v1/ip/geolocation?ip=177.224.0.1 | Vain osoitteen sijaintiarvio (DB-IP Lite), aina arvioksi merkittynä. | Omat aineistot | 30 · 30/min |
| GET/api/v1/ip/asn?ip=Kokeile: /api/v1/ip/asn?ip=2001:1208::1 | Osoitteen alkuperä-AS ja ilmoitettu prefiksi sekä rekisterin jako, johon se kuuluu. | Omat aineistot | 30 · 30/min |
| GET/api/v1/ip/reverse?ip=Kokeile: /api/v1/ip/reverse?ip=8.8.8.8 | Julkisen osoitteen PTR-tietue reaaliajassa eteenpäinvahvistuksen kanssa. | Reaaliaikainen kysely | 40 · 60/min |
| GET/api/v1/ip/blacklist?ip=Kokeile: /api/v1/ip/blacklist?ip=8.8.8.8 | Julkisen osoitteen DNSBL-tulokset reaaliajassa (SpamCop, PSBL, DroneBL, s5h.net) ja Tor-poistumissolmun merkintä. | Reaaliaikainen kysely | 40 · 60/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.ee/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/AS8151 | Autonomisen järjestelmän haltija, rekisteri ja ilmoitetut prefiksit. | Omat aineistot | 30 · 30/min |
| GET/api/v1/network/{cidr}Kokeile: /api/v1/network/144.122.0.0/16 | Verkko CIDR-muodossa: koko, alue, erikoiskäyttötila, kuka sen ilmoittaa (RPKI-tietoineen), rekisterin jako ja sijaintiarvio. | Omat aineistot | 30 · 30/min |
| GET/api/v1/network/ipv4?cidr=Kokeile: /api/v1/network/ipv4?cidr=192.168.1.37/24 | IPv4- tai IPv6-verkon aliverkkolaskenta: verkko, yleislähetysosoite, maskit, käytettävä alue ja määrät. | Omat aineistot | 120 · 240/min |
| GET/api/v1/network/ipv6?cidr=Kokeile: /api/v1/network/ipv6?cidr=2001:db8::/48 | IPv4- tai IPv6-verkon aliverkkolaskenta: verkko, yleislähetysosoite, maskit, käytettävä alue ja määrät. | Omat aineistot | 120 · 240/min |
| GET/api/v1/country/{cc}Kokeile: /api/v1/country/MX | Maan rekisteröity osoiteavaruus ja AS-numerot, mitä sen verkot ilmoittavat, RPKI-kattavuus ja suurimmat verkot (EE:lle myös maakuntakohtainen arvio). | Omat aineistot | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXKokeile: /api/v1/dns/metu.edu.tr?type=A,MX | Verkkotunnuksen DNS-tietueet reaaliajassa. | Reaaliaikainen kysely | 40 · 60/min |
| GET/api/v1/dns/propagation?name=&type=Kokeile: /api/v1/dns/propagation?name=metu.edu.tr&type=A | Sama DNS-kysymys usealle julkiselle nimipalvelimelle, kunkin vastaus ja tieto siitä, ovatko ne yhtä mieltä. | Reaaliaikainen kysely | 40 · 60/min |
| GET/api/v1/rdap/{query}Kokeile: /api/v1/rdap/AS8151 | 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 |
Pelkän tekstin pikapolut /api/v1:n ulkopuolella: /raw tulostaa osoitteesi, /json saman objektin kuin /my-ip, /country arvioidun maakoodisi.
Jokaisella polkupohjaisella päätepisteellä on myös kyselymuoto: /ip/lookup?ip=, /asn/lookup?asn=, /dns/lookup?name=, /network/cidr?cidr=. Jokainen vastaus sisältää X-Request-Id-otsakkeen.
curl ipaddress.ee/rawcurl ipaddress.ee/jsoncurl ipaddress.ee/countryKä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.