Gestion DNS

Les enregistrements suivent le format renvoyé par le registrar : identifiant record_id, hôte host, etc.

L’API refuse toute opération DNS sur un domaine qui n’est pas rattaché à votre compte (enregistrement domaine, service d’hébergement avec ce domaine, ou commande « domaine seul » en cours). Réponse typique : 404 not_found.

Lister les enregistrements DNS

GET /v1/domains/{domain}/dns
Authorization: Bearer kh_live_xxxx

Réponse : tableau d’objets du type :

{
  "success": true,
  "data": [
    {
      "record_id": "123456789",
      "type": "A",
      "host": "www",
      "value": "185.200.100.50",
      "ttl": 7207,
      "distance": 0
    }
  ]
}

Champ	Description
`record_id`	Identifiant côté registrar (à utiliser pour `PATCH` / `DELETE`)
`host`	Hôte DNS (`@` pour apex selon les cas)
`distance`	Priorité MX / distance SRV selon le type

Permission : domains:dns

Ajouter un enregistrement DNS

POST /v1/domains/{domain}/dns
Content-Type: application/json

{
  "type": "A",
  "host": "app",
  "value": "185.200.100.60",
  "ttl": 7207,
  "distance": 10
}

Champ	Requis	Description
`type`	Oui	`A`, `AAAA`, `CNAME`, `MX`, `TXT`, `NS`, `SRV`
`host`	Oui	Hôte (convention du registrar)
`value`	Oui	Valeur de l’enregistrement
`ttl`	Non	Entre 300 et 86400 (défaut serveur si omis)
`distance`	Non	Pour MX : priorité (défaut `10`)

Réponse (201) : objet incluant success et record_id.

Modifier un enregistrement

PATCH /v1/domains/{domain}/dns/{record_id}
Content-Type: application/json

Le segment {record_id} est la valeur record_id listée précédemment.

{
  "host": "app",
  "value": "185.200.100.61",
  "ttl": 7207,
  "distance": 10
}

Supprimer un enregistrement

DELETE /v1/domains/{domain}/dns/{record_id}

Réponse :

{
  "success": true,
  "data": { "deleted": true }
}

Permission

Toutes les routes DNS : domains:dns.

Introduction

Services

Domaines

Factures

API Revendeurs (White-Label)

Support

Parrainage

Webhooks

Lister les enregistrements DNS

Ajouter un enregistrement DNS

Modifier un enregistrement

Supprimer un enregistrement

Permission

​Lister les enregistrements DNS

​Ajouter un enregistrement DNS

​Modifier un enregistrement

​Supprimer un enregistrement

​Permission

Lister les enregistrements DNS

Ajouter un enregistrement DNS

Modifier un enregistrement

Supprimer un enregistrement

Permission