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

<Note>
  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`.
</Note>

## Lister les enregistrements DNS

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

**Réponse :** tableau d’objets du type :

```json
{
  "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

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

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

```http
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.

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

---

## Supprimer un enregistrement

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

**Réponse :**

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

## Permission

Toutes les routes DNS : **`domains:dns`**.