Référence API

API Couverture TLD

Répertorie les TLD associés à des correspondances RDAP ainsi que l’état de santé de points de terminaison représentatifs. Il ne s’agit pas d’une liste complète des TLD interrogeables ; certaines recherches utilisent WHOIS traditionnel comme solution de repli. Utilisez cette référence pour choisir une opération et intégrer son contrat de réponse documenté.

Opérations

GET /v1/coverage Voir la référence API

GET /v1/coverage

Opération: getCoverage Crédits et authentification: Gratuit Authentification facultative
GET /v1/coverage

Paramètres de Requête

Paramètre Type requis
live string
Valeurs autorisées 1
optionnel

Champs de Réponse

Champ Type
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

Exemple de Requête

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

Exemple de Réponse

{
  "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
  }
}

Ressources de référence