API
Tie patys duomenys kaip svetainėje, JSON ar paprasto teksto forma. Be rakto ir paskyros; taikomi sąžiningo naudojimo užklausų apribojimai.
curl https://ipaddress.ee/api/v1/my-ip?format=textGaliniai taškai
| Kelias | Aprašymas | Duomenys | Užklausų apribojimai |
|---|---|---|---|
| GET/api/v1/my-ipIšbandyti: /api/v1/my-ip | Jūsų IP adresas (taip pat kaip paprastas tekstas su ?format=text). | Nuosavi duomenų rinkiniai | 120 · 240/min. |
| GET/api/v1/ip/{address}Išbandyti: /api/v1/ip/144.122.145.153 | Adreso tinklo, maršrutizavimo, registro ir vietos duomenys. | Nuosavi duomenų rinkiniai | 30 · 30/min. |
| GET/api/v1/ip/geolocation?ip=Išbandyti: /api/v1/ip/geolocation?ip=177.224.0.1 | Tik adreso vietos įvertis (DB-IP Lite), visada pažymėtas kaip įvertis. | Nuosavi duomenų rinkiniai | 30 · 30/min. |
| GET/api/v1/ip/asn?ip=Išbandyti: /api/v1/ip/asn?ip=2001:1208::1 | Adreso kilmės AS ir skelbiamas prefiksas bei registro paskirstymas, kuriam jis priklauso. | Nuosavi duomenų rinkiniai | 30 · 30/min. |
| GET/api/v1/ip/reverse?ip=Išbandyti: /api/v1/ip/reverse?ip=8.8.8.8 | Viešo adreso PTR įrašas realiuoju laiku su tiesioginiu patvirtinimu. | Realaus laiko užklausa | 40 · 60/min. |
| GET/api/v1/ip/blacklist?ip=Išbandyti: /api/v1/ip/blacklist?ip=8.8.8.8 | DNSBL rezultatai realiuoju laiku (SpamCop, PSBL, DroneBL, s5h.net) ir Tor išėjimo mazgo požymis viešam adresui. | Realaus laiko užklausa | 40 · 60/min. |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.ee/api/v1/bulk | Iki 100 adresų vienu metu (JSON {"addresses": […]} arba po vieną eilutėje), atsakoma tik iš mūsų pačių duomenų rinkinių. Niekas nesaugoma. | Nuosavi duomenų rinkiniai | 6 · 3/min. |
| GET/api/v1/asn/{asn}Išbandyti: /api/v1/asn/AS8151 | Autonominės sistemos valdytojas, registras ir skelbiami prefiksai. | Nuosavi duomenų rinkiniai | 30 · 30/min. |
| GET/api/v1/network/{cidr}Išbandyti: /api/v1/network/144.122.0.0/16 | Tinklas CIDR žymėjimu: dydis, diapazonas, specialios paskirties būsena, kas jį skelbia (su RPKI), registro paskirstymas ir vietos įvertis. | Nuosavi duomenų rinkiniai | 30 · 30/min. |
| GET/api/v1/network/ipv4?cidr=Išbandyti: /api/v1/network/ipv4?cidr=192.168.1.37/24 | IPv4 ar IPv6 tinklo potinklių skaičiavimas: tinklas, transliavimo adresas, kaukės, naudojamas diapazonas ir kiekiai. | Nuosavi duomenų rinkiniai | 120 · 240/min. |
| GET/api/v1/network/ipv6?cidr=Išbandyti: /api/v1/network/ipv6?cidr=2001:db8::/48 | IPv4 ar IPv6 tinklo potinklių skaičiavimas: tinklas, transliavimo adresas, kaukės, naudojamas diapazonas ir kiekiai. | Nuosavi duomenų rinkiniai | 120 · 240/min. |
| GET/api/v1/country/{cc}Išbandyti: /api/v1/country/MX | Šalies užregistruota adresų erdvė ir AS numeriai, ką skelbia jos tinklai, RPKI aprėptis ir didžiausi tinklai (EE — taip pat įvertis pagal apskritis). | Nuosavi duomenų rinkiniai | 30 · 30/min. |
| GET/api/v1/dns/{domain}?type=A,MXIšbandyti: /api/v1/dns/metu.edu.tr?type=A,MX | Domeno DNS įrašai realiuoju laiku. | Realaus laiko užklausa | 40 · 60/min. |
| GET/api/v1/dns/propagation?name=&type=Išbandyti: /api/v1/dns/propagation?name=metu.edu.tr&type=A | Tas pats DNS klausimas keliems viešiesiems sprendikliams su kiekvienu atsakymu ir informacija, ar jie sutampa. | Realaus laiko užklausa | 40 · 60/min. |
| GET/api/v1/rdap/{query}Išbandyti: /api/v1/rdap/AS8151 | Registracijos duomenys iš autoritetingo RDAP serverio. | Realaus laiko užklausa | 10 · 6/min. |
| GET/api/v1/healthIšbandyti: /api/v1/health | Paslaugos veikimas. | Nuosavi duomenų rinkiniai | 120 · 240/min. |
| GET/api/v1/data-statusIšbandyti: /api/v1/data-status | Kiekvieno duomenų rinkinio amžius ir dydis. | Nuosavi duomenų rinkiniai | 120 · 240/min. |
Paprasto teksto nuorodos už /api/v1 ribų: /raw išveda jūsų adresą, /json — tą patį objektą kaip /my-ip, /country — jūsų įvertintą šalies kodą.
Kiekvienas kelio galinis taškas turi ir užklausos formą: /ip/lookup?ip=, /asn/lookup?asn=, /dns/lookup?name=, /network/cidr?cidr=. Kiekviename atsakyme yra X-Request-Id antraštė.
curl ipaddress.ee/rawcurl ipaddress.ee/jsoncurl ipaddress.ee/countryUžklausų apribojimai
Užklausos ribojamos kiekvienam kliento adresui žetonų kibiro (token bucket) metodu. Pasiekus ribą, API atsako 429 su Retry-After antrašte. Apribojimai skaičiuojami atmintyje su maišos raktu, kuris keičiamas kasdien; adresai nesaugomi.
Klaidos
Klaidoms naudojami HTTP būsenos kodai ir JSON turinys tokia forma: {"error": {"code": "…", "message": "…"}}.
Versijos
Keliai po /api/v1/ išlaiko atsakymo struktūrą. Gali būti pridedami nauji laukai; esami laukai v1 ribose nešalinami ir nepervadinami.
Šaltinio nurodymas
Vietos duomenys gaunami iš DB-IP (CC BY 4.0). Jei juos rodote, nurodykite DB-IP, kaip reikalauja licencija.