API
Aceleași date ca pe site, în format JSON sau text simplu. Fără cheie, fără cont; se aplică limite de utilizare rezonabilă.
curl https://ipaddress.ro/api/v1/my-ip?format=textEndpointuri
| Cale | Descriere | Date | Limite de cereri |
|---|---|---|---|
| GET/api/v1/my-ipÎncearcă: /api/v1/my-ip | Adresa ta IP (și ca text simplu, cu ?format=text). | Seturi de date proprii | 120 · 240/min |
| GET/api/v1/ip/{address}Încearcă: /api/v1/ip/81.196.1.152 | Date de rețea, rutare, registru și localizare pentru o adresă. | Seturi de date proprii | 30 · 30/min |
| GET/api/v1/asn/{asn}Încearcă: /api/v1/asn/AS8708 | Titularul, registrul și prefixele anunțate ale unui sistem autonom. | Seturi de date proprii | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXÎncearcă: /api/v1/dns/rotld.ro?type=A,MX | Înregistrările DNS live ale unui domeniu. | Interogare live | 40 · 60/min |
| GET/api/v1/rdap/{query}Încearcă: /api/v1/rdap/AS8708 | Date de înregistrare de la serverul RDAP autoritar. | Interogare live | 10 · 6/min |
| GET/api/v1/healthÎncearcă: /api/v1/health | Dacă serviciul funcționează. | Seturi de date proprii | 120 · 240/min |
| GET/api/v1/data-statusÎncearcă: /api/v1/data-status | Vechimea și dimensiunea fiecărui set de date. | Seturi de date proprii | 120 · 240/min |
Limite de cereri
Cererile sunt limitate pentru fiecare adresă de client, cu un algoritm token bucket. Când limita este atinsă, API-ul răspunde cu 429 și antetul Retry-After. Limitele sunt numărate în memorie, cu o cheie hash rotită zilnic; adresele nu sunt stocate.
Erori
Erorile folosesc coduri de stare HTTP și un corp JSON de forma {"error": {"code": "…", "message": "…"}}.
Versionare
Căile de sub /api/v1/ își păstrează structura răspunsului. Pot fi adăugate câmpuri noi; câmpurile existente nu sunt eliminate sau redenumite în cadrul v1.
Atribuire
Datele de localizare provin de la DB-IP (CC BY 4.0). Dacă le afișezi, menționează DB-IP, așa cum cere licența.