DNS-Eintrag hinzufügen

Fügt einen neuen DNS-Eintrag zu einer Domain hinzu.

Anfrage

POST /api/v1/domains/{id}/dns

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter	Typ	Beschreibung
`id`	string	Die Domain-ID

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`
`Content-Type`	Ja	`application/json`

Anfragekörper

Feld	Typ	Erforderlich	Beschreibung
`type`	string	Ja	DNS-Eintragstyp. Einer von: `A`, `AAAA`, `CNAME`, `ALIAS`, `MX`, `SRV`, `TXT`, `CAA`, `NS`, `TLSA`, `SSHFP`
`name`	string	Ja	Eintragsname (z.B. `@` für Root, `www` für Subdomain)
`ttl`	number	Ja	Time to Live in Sekunden (Minimum 60)
`data`	string	Ja	Eintragswert (z.B. `1.2.3.4` für einen A-Eintrag)

Antwort

{
  "data": {
    "success": true
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`data.success`	boolean	Ob der Eintrag erfolgreich erstellt wurde

Fehler

Status	Code	Beschreibung
400	`INVALID_TYPE`	Der angegebene DNS-Eintragstyp ist ungültig
400	`INVALID_NAME`	Der angegebene Eintragsname ist ungültig
400	`INVALID_TTL`	Der angegebene TTL-Wert ist ungültig (muss mindestens 60 sein)
400	`INVALID_DATA`	Die angegebenen Eintragsdaten sind ungültig
404	`NOT_FOUND`	Die Domain wurde nicht gefunden
502	`PROVIDER_ERROR`	Der DNS-Provider hat einen Fehler zurückgegeben

Beispiel

curl -X POST https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/dns \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "@",
    "ttl": 3600,
    "data": "1.2.3.4"
  }'

MCP

Diese Aktion ist auch über das add_dns_record MCP-Tool verfügbar.