API
Tie paši dati, kas vietnē, JSON vai vienkārša teksta formā. Bez atslēgas un konta; ir godīgas lietošanas pieprasījumu ierobežojumi.
curl https://ipaddress.ee/api/v1/my-ip?format=textGalapunkti
| Ceļš | Apraksts | Dati | Pieprasījumu ierobežojumi |
|---|---|---|---|
| GET/api/v1/my-ipIzmēģināt: /api/v1/my-ip | Jūsu IP adrese (arī kā vienkāršs teksts ar ?format=text). | Pašu datu kopas | 120 · 240/min |
| GET/api/v1/ip/{address}Izmēģināt: /api/v1/ip/144.122.145.153 | Adreses tīkla, maršrutēšanas, reģistra un atrašanās vietas dati. | Pašu datu kopas | 30 · 30/min |
| GET/api/v1/ip/geolocation?ip=Izmēģināt: /api/v1/ip/geolocation?ip=177.224.0.1 | Tikai adreses atrašanās vietas aplēse (DB-IP Lite), vienmēr atzīmēta kā aplēse. | Pašu datu kopas | 30 · 30/min |
| GET/api/v1/ip/asn?ip=Izmēģināt: /api/v1/ip/asn?ip=2001:1208::1 | Adreses izcelsmes AS un izsludinātais prefikss, kā arī reģistra piešķīrums, kurā tā ietilpst. | Pašu datu kopas | 30 · 30/min |
| GET/api/v1/ip/reverse?ip=Izmēģināt: /api/v1/ip/reverse?ip=8.8.8.8 | Publiskas adreses PTR ieraksts reāllaikā ar tiešā DNS apstiprinājumu. | Reāllaika vaicājums | 40 · 60/min |
| GET/api/v1/ip/blacklist?ip=Izmēģināt: /api/v1/ip/blacklist?ip=8.8.8.8 | DNSBL rezultāti reāllaikā (SpamCop, PSBL, DroneBL, s5h.net) un Tor izejas mezgla pazīme publiskai adresei. | Reāllaika vaicājums | 40 · 60/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.ee/api/v1/bulk | Līdz 100 adresēm uzreiz (JSON {"addresses": […]} vai pa vienai rindā), atbildot tikai no mūsu pašu datu kopām. Nekas netiek saglabāts. | Pašu datu kopas | 6 · 3/min |
| GET/api/v1/asn/{asn}Izmēģināt: /api/v1/asn/AS8151 | Autonomās sistēmas turētājs, reģistrs un izsludinātie prefiksi. | Pašu datu kopas | 30 · 30/min |
| GET/api/v1/network/{cidr}Izmēģināt: /api/v1/network/144.122.0.0/16 | Tīkls CIDR pierakstā: izmērs, diapazons, īpaša nolūka statuss, kas to izsludina (ar RPKI), reģistra piešķīrums un atrašanās vietas aplēse. | Pašu datu kopas | 30 · 30/min |
| GET/api/v1/network/ipv4?cidr=Izmēģināt: /api/v1/network/ipv4?cidr=192.168.1.37/24 | IPv4 vai IPv6 tīkla apakštīklu aprēķins: tīkls, apraides adrese, maskas, izmantojamais diapazons un skaiti. | Pašu datu kopas | 120 · 240/min |
| GET/api/v1/network/ipv6?cidr=Izmēģināt: /api/v1/network/ipv6?cidr=2001:db8::/48 | IPv4 vai IPv6 tīkla apakštīklu aprēķins: tīkls, apraides adrese, maskas, izmantojamais diapazons un skaiti. | Pašu datu kopas | 120 · 240/min |
| GET/api/v1/country/{cc}Izmēģināt: /api/v1/country/MX | Valsts reģistrētā adrešu telpa un AS numuri, ko izsludina tās tīkli, RPKI pārklājums un lielākie tīkli (EE — arī aplēse pa apriņķiem). | Pašu datu kopas | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXIzmēģināt: /api/v1/dns/metu.edu.tr?type=A,MX | Domēna DNS ieraksti reāllaikā. | Reāllaika vaicājums | 40 · 60/min |
| GET/api/v1/dns/propagation?name=&type=Izmēģināt: /api/v1/dns/propagation?name=metu.edu.tr&type=A | Viens un tas pats DNS jautājums vairākiem publiskiem resolveriem ar katru atbildi un to, vai tās sakrīt. | Reāllaika vaicājums | 40 · 60/min |
| GET/api/v1/rdap/{query}Izmēģināt: /api/v1/rdap/AS8151 | Reģistrācijas dati no autoritatīvā RDAP servera. | Reāllaika vaicājums | 10 · 6/min |
| GET/api/v1/healthIzmēģināt: /api/v1/health | Pakalpojuma darbspēja. | Pašu datu kopas | 120 · 240/min |
| GET/api/v1/data-statusIzmēģināt: /api/v1/data-status | Katras datu kopas vecums un apjoms. | Pašu datu kopas | 120 · 240/min |
Vienkārša teksta saīsnes ārpus /api/v1: /raw izdrukā jūsu adresi, /json — to pašu objektu kā /my-ip, /country — jūsu aplēsto valsts kodu.
Katram ceļa galapunktam ir arī vaicājuma forma: /ip/lookup?ip=, /asn/lookup?asn=, /dns/lookup?name=, /network/cidr?cidr=. Katrā atbildē ir galvene X-Request-Id.
curl ipaddress.ee/rawcurl ipaddress.ee/jsoncurl ipaddress.ee/countryPieprasījumu ierobežojumi
Pieprasījumi tiek ierobežoti katrai klienta adresei ar marķieru spaini (token bucket). Kad limits sasniegts, API atbild ar 429 un galveni Retry-After. Ierobežojumi tiek skaitīti atmiņā ar jaucējkodētu, katru dienu mainītu atslēgu; adreses netiek glabātas.
Kļūdas
Kļūdām tiek izmantoti HTTP statusa kodi un JSON pamatteksts formā {"error": {"code": "…", "message": "…"}}.
Versijas
Ceļi zem /api/v1/ saglabā atbildes struktūru. Var tikt pievienoti jauni lauki; esošie lauki v1 ietvaros netiek noņemti vai pārdēvēti.
Atsauce uz avotu
Atrašanās vietas dati nāk no DB-IP (CC BY 4.0). Ja tos rādāt, norādiet DB-IP, kā to prasa licence.