Unterstützte DNS-Einträge ersetzen und DNSSEC setzen

Anfrage, Parameter und Antworten für diesen API-Endpunkt.

PUT/api/v1/customer/products/{id}/domain/dns

Überblick

Dieser Endpunkt benötigt einen API-Schlüssel mit Schreibzugriff. Sein Ersteller muss weiterhin der Benutzer des Kundenkontos sein.

Header & Parameter

AuthorizationBearer $SYSTEY_API_KEY · erforderlich

Content-Typeapplication/json

idpath · erforderlich

{"type":"string","format":"uuid"}

Idempotency-Keyheader · erforderlich

{"type":"string","format":"uuid"}

Neue UUID pro Aktion. Bei Wiederholung dieselbe UUID und denselben Inhalt verwenden.

Anfrage-Body

Senden Sie ein JSON-Objekt. Pflichtfelder beziehen sich auf das jeweilige Objekt. Zusätzlich gelten die fachlichen Voraussetzungen des jeweiligen Endpunkts; unbekannte Felder werden abgewiesen.

Schemafelder und Anforderungen
Feld	Typ	Pflicht
`records` maxItems: 200	array	Ja
`records[]`	object	—
`records[].name`	string	Ja
`records[].type` "A" \| "AAAA" \| "CNAME" \| "MX" \| "TXT" \| "SRV" \| "CAA" \| "ALIAS"	string	Ja
`records[].value`	string	Ja
`records[].ttl` min: 60 · max: 86400	integer	Ja
`records[].pref` min: 0 · max: 65535	integer	—
`dnssec`	boolean	Ja

Beispielanfrage

Ersetzen Sie Platzhalter durch eigene Werte. Speichern Sie $REQUEST_UUID vor einer schreibenden Aktion, sofern dieser Endpunkt einen Idempotency-Key benötigt.

cURL

curl -i -X PUT "https://systey.com/api/v1/customer/products/<resource UUID>/domain/dns" \
  -H "Authorization: Bearer $SYSTEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_UUID" \
  --data '{
  "records": [
    {
      "name": "@",
      "type": "A",
      "value": "203.0.113.10",
      "ttl": 3600
    }
  ],
  "dnssec": false
}'

Antwort

HTTP 200

Schemafelder und Anforderungen
Feld	Typ	Pflicht
`data`	object	Ja
`data.message`	string	Ja

Fehler

Fehlerantworten enthalten error sowie optional message und details. Rate-Limit: 120 Anfragen pro Minute und Schlüssel. Bei HTTP 429 den Retry-After-Header beachten.