API
Samad andmed mis veebisaidil, JSON-i või lihttekstina. Ilma võtme ja kontota; kehtivad õiglase kasutuse päringupiirangud.
curl https://ipaddress.ee/api/v1/my-ip?format=textLõpp-punktid
| Tee | Kirjeldus | Andmed | Päringupiirangud |
|---|---|---|---|
| GET/api/v1/my-ipProovi: /api/v1/my-ip | Sinu IP-aadress (ka lihttekstina parameetriga ?format=text). | Omad andmekogud | 120 · 240/min |
| GET/api/v1/ip/{address}Proovi: /api/v1/ip/144.122.145.153 | Aadressi võrgu-, marsruutimis-, registri- ja asukohaandmed. | Omad andmekogud | 30 · 30/min |
| GET/api/v1/ip/geolocation?ip=Proovi: /api/v1/ip/geolocation?ip=177.224.0.1 | Ainult aadressi asukohahinnang (DB-IP Lite), alati märgitud hinnanguna. | Omad andmekogud | 30 · 30/min |
| GET/api/v1/ip/asn?ip=Proovi: /api/v1/ip/asn?ip=2001:1208::1 | Aadressi lähte-AS ja välja kuulutatud prefiks ning registri jaotus, kuhu see kuulub. | Omad andmekogud | 30 · 30/min |
| GET/api/v1/ip/reverse?ip=Proovi: /api/v1/ip/reverse?ip=8.8.8.8 | Avaliku aadressi PTR-kirje reaalajas koos päri-DNS-i kinnitusega. | Reaalajas päring | 40 · 60/min |
| GET/api/v1/ip/blacklist?ip=Proovi: /api/v1/ip/blacklist?ip=8.8.8.8 | Avaliku aadressi DNSBL-tulemused reaalajas (SpamCop, PSBL, DroneBL, s5h.net) ja Tori väljundsõlme tunnus. | Reaalajas päring | 40 · 60/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.ee/api/v1/bulk | Kuni 100 aadressi korraga (JSON {"addresses": […]} või üks rea kohta), vastatakse ainult meie enda andmekogudest. Midagi ei salvestata. | Omad andmekogud | 6 · 3/min |
| GET/api/v1/asn/{asn}Proovi: /api/v1/asn/AS8151 | Autonoomse süsteemi haldaja, register ja välja kuulutatud prefiksid. | Omad andmekogud | 30 · 30/min |
| GET/api/v1/network/{cidr}Proovi: /api/v1/network/144.122.0.0/16 | Võrk CIDR-kirjaviisis: suurus, vahemik, eriotstarbeline olek, kes seda välja kuulutab (koos RPKI-ga), registri jaotus ja asukohahinnang. | Omad andmekogud | 30 · 30/min |
| GET/api/v1/network/ipv4?cidr=Proovi: /api/v1/network/ipv4?cidr=192.168.1.37/24 | IPv4- või IPv6-võrgu alamvõrguarvutus: võrk, leviaadress, maskid, kasutatav vahemik ja arvud. | Omad andmekogud | 120 · 240/min |
| GET/api/v1/network/ipv6?cidr=Proovi: /api/v1/network/ipv6?cidr=2001:db8::/48 | IPv4- või IPv6-võrgu alamvõrguarvutus: võrk, leviaadress, maskid, kasutatav vahemik ja arvud. | Omad andmekogud | 120 · 240/min |
| GET/api/v1/country/{cc}Proovi: /api/v1/country/MX | Riigi registreeritud aadressiruum ja AS-numbrid, mida selle võrgud välja kuulutavad, RPKI katvus ja suurimad võrgud (EE puhul ka hinnang maakondade kaupa). | Omad andmekogud | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXProovi: /api/v1/dns/metu.edu.tr?type=A,MX | Domeeni DNS-kirjed reaalajas. | Reaalajas päring | 40 · 60/min |
| GET/api/v1/dns/propagation?name=&type=Proovi: /api/v1/dns/propagation?name=metu.edu.tr&type=A | Sama DNS-küsimus mitmele avalikule resolverile koos iga vastusega ja märkega, kas need ühtivad. | Reaalajas päring | 40 · 60/min |
| GET/api/v1/rdap/{query}Proovi: /api/v1/rdap/AS8151 | Registreerimisandmed autoriteetselt RDAP-serverilt. | Reaalajas päring | 10 · 6/min |
| GET/api/v1/healthProovi: /api/v1/health | Teenuse elusoleku kontroll. | Omad andmekogud | 120 · 240/min |
| GET/api/v1/data-statusProovi: /api/v1/data-status | Iga andmekogu vanus ja suurus. | Omad andmekogud | 120 · 240/min |
Lihtteksti otseteed väljaspool /api/v1: /raw näitab sinu aadressi, /json sama objekti mis /my-ip, /country sinu hinnangulist riigikoodi.
Igal tee-põhisel lõpp-punktil on ka päringuparameetriga kuju: /ip/lookup?ip=, /asn/lookup?asn=, /dns/lookup?name=, /network/cidr?cidr=. Iga vastus sisaldab päist X-Request-Id.
curl ipaddress.ee/rawcurl ipaddress.ee/jsoncurl ipaddress.ee/countryPäringupiirangud
Päringuid piiratakse kliendi aadressi kohta žetoonikopa (token bucket) meetodil. Kui piir on täis, vastab API koodiga 429 ja päisega Retry-After. Piiranguid loetakse mälus räsitud ja iga päev vahetuva võtmega; aadresse ei salvestata.
Vead
Vigade puhul kasutatakse HTTP olekukoode ja JSON-keha kujul {"error": {"code": "…", "message": "…"}}.
Versioonid
Teede /api/v1/ all säilib vastuse kuju. Uusi välju võidakse lisada; olemasolevaid välju v1 piires ei eemaldata ega nimetata ümber.
Viitamine
Asukohaandmed pärinevad DB-IP-lt (CC BY 4.0). Kui neid kuvad, viita litsentsi nõudel DB-IP-le.