Référence Développeur

Couverture TLD

Consultez la documentation de l'API Couverture TLD, ses paramètres de requête, les champs de réponse, les exemples de code et la gestion des erreurs pour les intégrations DomScan.

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.

GET /v1/coverage

Paramètres de Requête

Paramètre	Type	Description
live optionnel	boolean	Sonder une fois chacun des 10 hôtes RDAP représentatifs au maximum (plus lent).

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