Riferimento API

API Copertura TLD

Elenca i TLD con mappature RDAP e lo stato di endpoint rappresentativi. Non è un elenco completo dei TLD consultabili; alcune ricerche usano il WHOIS tradizionale come ripiego. Usa questo riferimento per scegliere un’operazione e integrare il relativo contratto di risposta documentato.

Operazioni

GET /v1/coverage Vedi il riferimento API

GET /v1/coverage

Operazione: getCoverage Crediti e autenticazione: Gratis Autenticazione facoltativa
GET /v1/coverage

Parametri di query

Parametro Tipo obbligatorio
live string
Valori consentiti 1
facoltativo

Campi di risposta

Campo Tipo
gtlds[] string[]
cctlds[] string[]
total_tlds integer
all_tlds[] string[]
rdap_health[] object[]
rdap_health[] object
rdap_health[].tld string
rdap_health[].endpoint string
rdap_health[].measurement_status string
rdap_health[].ok boolean | null
rdap_health[].p50_ms number | null
rdap_health[].error_rate number | null
bootstrap_source string
bootstrap_last_updated string
meta object
meta.served_by string
meta.bootstrap_ttl_s integer
meta.live boolean

Richiesta di esempio

curl "https://domscan.net/v1/coverage?live=1"

Risposta di esempio

{
  "gtlds": [
    "example"
  ],
  "cctlds": [
    "example"
  ],
  "total_tlds": 1,
  "all_tlds": [
    "com"
  ],
  "rdap_health": [
    {
      "tld": "com",
      "endpoint": "https://example.com",
      "measurement_status": "single_probe",
      "ok": true,
      "p50_ms": 1.5,
      "error_rate": 0
    }
  ],
  "bootstrap_source": "iana",
  "bootstrap_last_updated": "2026-08-27T12:00:00Z",
  "meta": {
    "served_by": "example",
    "bootstrap_ttl_s": 1,
    "live": false
  }
}

Risorse di riferimento