API
Gli stessi dati del sito, in JSON o testo semplice. Nessuna chiave, nessun account; si applicano limiti di uso corretto.
curl https://ipaddress.ro/api/v1/my-ip?format=textEndpoint
| Percorso | Descrizione | Dati | Limiti di richieste |
|---|---|---|---|
| GET/api/v1/my-ipProva: /api/v1/my-ip | Il tuo indirizzo IP (anche come testo semplice con ?format=text). | Set di dati propri | 120 · 240/min |
| GET/api/v1/ip/{address}Prova: /api/v1/ip/81.196.1.152 | Dati di rete, routing, registro e posizione di un indirizzo. | Set di dati propri | 30 · 30/min |
| GET/api/v1/asn/{asn}Prova: /api/v1/asn/AS8708 | Titolare, registro e prefissi annunciati di un sistema autonomo. | Set di dati propri | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXProva: /api/v1/dns/rotld.ro?type=A,MX | Record DNS in tempo reale di un dominio. | Interrogazione in tempo reale | 40 · 60/min |
| GET/api/v1/rdap/{query}Prova: /api/v1/rdap/AS8708 | Dati di registrazione dal server RDAP competente. | Interrogazione in tempo reale | 10 · 6/min |
| GET/api/v1/healthProva: /api/v1/health | Stato di funzionamento del servizio. | Set di dati propri | 120 · 240/min |
| GET/api/v1/data-statusProva: /api/v1/data-status | Età e dimensione di ogni set di dati. | Set di dati propri | 120 · 240/min |
Limiti di richieste
Le richieste sono limitate per indirizzo client con un token bucket. Al raggiungimento del limite l'API risponde 429 con l'header Retry-After. I limiti sono conteggiati in memoria con una chiave hash ruotata ogni giorno; gli indirizzi non vengono memorizzati.
Errori
Gli errori usano i codici di stato HTTP e un corpo JSON della forma {"error": {"code": "…", "message": "…"}}.
Versionamento
I percorsi sotto /api/v1/ mantengono la struttura della risposta. Possono essere aggiunti nuovi campi; quelli esistenti non vengono rimossi né rinominati nella v1.
Attribuzione
I dati di posizione provengono da DB-IP (CC BY 4.0). Se li mostri, cita DB-IP come richiesto dalla licenza.