DNS-Record anlegen

POST /dns/rr

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 (60-604800)
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

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