DNS-Record anlegen

POST /dns/rr

Bezeichner: AddRecord

Legt einen neuen DNS-Record an und ermittelt die Zone automatisch anhand des fqdn aus dem Parameter name.

Request Body

recordRequestFQDN

Feld	Typ	Pflicht	Beschreibung
`name`	fqdn	ja	Fully Qualified Domain Name (FQDN, mit abschließendem Punkt).
`type`	type	nein
`ttl`	ttl	nein	Time To Live in Sekunden (60-86400)
`annotation`	`string`	nein	Freie Notiz zu diesem Record.

Dazu die Felder einer der folgenden Varianten:

Variante	Felder
`A`	`data`: ipv4
`AAAA`	`data`: ipv6
`CNAME`	`data`: fqdn
`CAA`	`flags`: `integer`, `tag`: `string`, `data`: `string`
`ALIAS`	`data`: fqdn
`MX`	`data`: fqdn, `priority`: `integer`
`TXT`	`data`: `string`
`SRV`	`priority`: `integer`, `weight`: `integer`, `port`: `integer`, `data`: fqdn
`TLSA`	`usage`: `integer`, `selector`: `integer`, `matching_type`: `integer`, `data`: `string`

Antworten

Status	Typ	Beschreibung
`200`	`recordResponse`	Der angelegte Record mit seiner neuen ID
`400`	`Error`	Ungültige Anfrage
`401`	`Error`	Nicht autorisiert
`404`	`Error`	Keine passende DNS-Zone gefunden
`417`	`Error`	Das Anlegen des DNS-Records verletzt eine Beschränkung der Zone
`429`	`Error`	Rate-Limit für ACME-Plattform-Zugänge (Scope `acme-dns-challenge`): Aufrufe pro Minute sowie verschiedene Kunden pro Tag. Gewöhnliche Kundenschlüssel erhalten diesen Status auf diesem Endpunkt nie.
`500`	`Error`	Unerwarteter Fehler

Antwortkörper

Feld	Typ	Pflicht	Beschreibung
`success`	`boolean`	ja	Erfolgskennzeichen
`code`	`integer`	nein	Antwort-/Fehlercode
`response`	recordResponse	nein

Beispiel

curl -X POST "https://api.regfish.com/dns/rr" \
  -H "x-api-key: $REGFISH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "www",
    "type": "A",
    "ttl": 600,
    "annotation": "string",
    "data": "12.12.12.12"
  }'

Anfrage zusammenstellen

Werte eintragen: Der Aufruf unten passt sich an. Es wird nichts abgeschickt: die API gibt Browser-Anfragen von dieser Domain aus derzeit nicht frei (CORS). Der API-Key wird nicht gespeichert.