Dieser Artikel behandelt WAPI-Befehle speziell für den Dienst WEDOS DNS. Informationen zur Einrichtung von WAPI und zur Behebung häufiger Probleme finden Sie im Artikel WAPI – Handbuch.
Dieser Artikel enthält Informationen zu den folgenden Anfragen:
- dns-domains-list – Liste der DNS-Domains im Konto des Benutzers
- dns-domain-info – Informationen über die Domain
- dns-domain-add – Domain zum DNS hinzufügen
- dns-domain-update – Domain im DNS aktualisieren
- dns-domain-delete – Domain aus dem DNS löschen
- dns-domain-axfr-run – AXFR-Transfer vom Primärserver zu unserem DNS anfordern
- dns-domain-axfr-tsig – AXFR-TSIG-Einstellungen aktualisieren oder prüfen
- dns-domain-copy – Domain durch Kopieren einer anderen Domain zum DNS hinzufügen
- dns-domain-commit – DNS-Änderungen speichern
- dns-rows-list – Liste der Domaineinträge abrufen
- dns-row-detail – Detail des Eintrags abrufen
- dns-row-add – Eintrag hinzufügen
- dns-row-update – Eintrag bearbeiten
- dns-row-delete – Eintrag löschen
dns-domains-list
Verwenden Sie dns-domains-list Anfrage zum Auflisten der DNS-Domains des Benutzers.
Parameter
- Suche – Zeichenkette, nach der in den Domainnamen gesucht wird – optional
- Status – nach Status filtern (active, disabled) – optional
- Typ – nach Domaintyp filtern (primary, secondary) – optional
- Seite – Seitenzahl (Standard: 1) – optional
- page_limit – Anzahl der Einträge pro Seite (Standard: 50) – optional
- orderby – Einträge sortieren nach created_date oder domain, gefolgt von asc/desc – optional, siehe Vorlage
Rückgabewerte
- 1000 – OK
Antwortdaten
Die Anfrage liefert eine Liste der Domains zurück, die diese Vorlage verwenden:
- domain
- Name – Domainname
- Status – Status der Domain im System
- Typ – Typ (primary/secondary)
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domains-list",
"clTRID": "your ID",
"data": {
"search": "search term in domain name",
"status": "active|disabled",
"type": "primary|secondary",
"page": "page number",
"page_limit": "number of entries per page",
"orderby":"domain|created_date asc|desc"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domains-list",
"data": {
"domain": [
{
"name": "domain1 name in DNS",
"type": "type (primary|secondary)",
"status": "active|disabled"
}
],
"total": "počet položek celkem",
"page": "číslo stránky",
"page_limit": "počet položek na stránku"
}
}
}
dns-domain-info
Verwenden Sie dns-domain-info Anfrage zum Abrufen grundlegender Informationen zu einer oder mehreren Domains im WEDOS DNS System (WDNS).
Parameter
- Name – Domainname, bei mehreren Domains eine durch Kommas getrennte Zeichenkette verwenden (siehe Vorlage) – erforderlich
Rückgabewerte
- 1000= OK
- 2201= nicht unterstützte TLD
- 2202= ungültiger Domainname
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Autorisierungsfehler
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
Der Rückgabewert für mehrere Domains ist immer 1000. Etwaige Fehlerwerte werden angezeigt in domain Daten, wie in der Vorlage gezeigt.
Rückgabedaten
Bei Erfolg gibt die Anfrage das Domain-Detail in WDNS im Knoten data/domain zurück.
Vorlagen
JSON-Anfrage mit 2 Domains:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-info",
"clTRID": "your ID",
"data": {
"name": "domain.name1, domain.name2"
}
}
}
JSON-Antwort (domain.name1 OK, domain.name2 Fehler):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-info",
"data": {
"domain": [{
"name": "domain.name1",
"status": "",
"type": "",
"tlock": "",
"autocommit": "",
"axfr_enabled": "outgoing axfr enabled? (0/1)",
"axfr_ips": "allowed axfr IPs list",
"changed": "",
"changed_date": "",
"commit_date": "",
"reload_pending": "",
"reload_pending_date": "",
"reload_date": "",
"disabled_date": "",
"enabled_date": "",
"add_date": "",
"rname": "",
"serial": "",
"refresh": "",
"retry": "",
"expire": "",
"minimum": "",
"rr_cnt6": "",
"ns_out": "",
"ns1": ""
},
{
"name": "domain.name2",
"code": 3222,
"result": "Domain open failed"
}]
}
}
}
dns-domain-add
Verwenden Sie dns-domain-add Anfrage zum Hinzufügen einer neuen Domain zum DNS.
Parameter
- Name – Domainname, oder mehrere durch Komma getrennte Namen (erforderlich)
- Typ – Typ des Domaineintrags (primary/secondary) – optional (Standard: primary)
- axfr_enabled – ist ausgehendes AXFR aktiviert? (0/1) – nur primäre Domains, optional (Standard: 0)
- axfr_ips – Liste der für AXFR freigegebenen IP-Adressen (nur für primären Eintrag, mehrere Adressen als durch Leerzeichen getrennte Liste eingeben; erforderlich bei axfr_enabled=1)
- primary_ip – IP-Adressen des primären DNS-Servers (erforderlich bei type=secondary)
- primary_tsig_enabled – ist TSIG aktiviert? (0/1) – nur sekundäre Domains, optional
- primary_tsig_name – TSIG-Kennung – nur sekundäre Domains, erforderlich bei aktiviertem TSIG
- primary_tsig_alg – TSIG-Algorithmus – nur sekundäre Domains, erforderlich bei aktiviertem TSIG
- primary_tsig_key – TSIG-Schlüssel – nur sekundäre Domains, erforderlich bei aktiviertem TSIG
- template_id – ID einer Domain vom Typ Vorlage – nur primäre Domain, optional
Rückgabewerte
- 1000 = ok
- 2007 = maximale Anfragegröße überschritten
- 2100 = erforderlicher Parameter fehlt
- 2101= ungültige Eingabeparameter
- 2201 = nicht unterstützte TLD
- 2202 = ungültiger Domainname
- 2301 = falsches Format des Typs
- 2302 = Parameter primary_ip fehlt
- 2303 = falsches Format von primary_ip
- 2304 = ungültiges Format von axfr_enabled
- 2305 = erforderlicher Parameter axfr_ips fehlt
- 2306 = ungültiges Format von axfr_ips
- 2308 = ungültiges Format von ns
- 2322 = Limit der Domains im DNS pro Benutzer erreicht
- 2323 = Vorlage nicht gefunden
- 2324 = Die primäre Domain kann nicht über eine Vorlage angelegt werden
- 2325 = nicht definierte Vorlage
- 2330 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültige Konfiguration
- 2331 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültiges Format des Namens
- 2332 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültiges Format des Algorithmus
- 2333 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültiges Format des Schlüssels
- 2340 = max. Anzahl der Domains bei einer einzelnen Aktion überschritten
- 3302 = Hinzufügen der Domain zum DNS fehlgeschlagen
- 3303 = Domain existiert im DNS bereits
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Anfrage – primäre Domain:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-add",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"axfr_enabled": "0 or 1",
"axfr_ips": "allowed AXFR address(es)",
"template_id": "ID of domain records template"
}
}
}
JSON-Anfrage – sekundäre Domain:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-add",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"type": "secondary",
"primary_ip": "primary IP address",
"primary_tsig_enabled": "0 or 1",
"primary_tsig_name": "tsig_identifier",
"primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
"primary_tsig_key": "TSIG_key_value"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-add"
}
}
JSON-Antwort für mehrere Domains:
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-add",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
"domain_id":"service ID"
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
"domain_id":"service ID"
}
]
}
}
dns-domain-update
Verwenden Sie dns-domain-update Anfrage zum Bearbeiten der Domain im DNS.
Parameter
- Name – Domainname, oder mehrere durch Komma getrennte Namen (erforderlich)
- axfr_enabled – ist ausgehendes AXFR aktiviert? (0/1) – nur primäre Domains, optional (Standard: 0)
- axfr_ips – Liste der für AXFR freigegebenen IP-Adressen (nur für primären Eintrag, erforderlich bei axfr_enabled=1)
- ip – IP-Adresse für ausgehendes AXFR
- primary_ip – IP-Adressen des primären DNS-Servers (erforderlich bei type=secondary)
- primary_tsig_enabled – ist TSIG aktiviert? (0/1) – nur sekundäre Domains, optional
- primary_tsig_name – TSIG-Kennung – nur sekundäre Domains, erforderlich bei aktiviertem TSIG
- primary_tsig_alg – TSIG-Algorithmus – nur sekundäre Domains, erforderlich bei aktiviertem TSIG
- primary_tsig_key – TSIG-Schlüssel – nur sekundäre Domains, erforderlich bei aktiviertem TSIG
Rückgabewerte
- 1000 = ok
- 2007= maximale Anfragegröße überschritten
- 2100 = erforderlicher Parameter fehlt
- 2101= ungültige Eingabeparameter
- 2201 = nicht unterstützte TLD
- 2202 = ungültiger Domainname
- 2302 = Parameter primary_ip fehlt
- 2303 = falsches Format von primary_ip
- 2304 = ungültiges Format von axfr_enabled
- 2305 = erforderlicher Parameter axfr_ips fehlt
- 2306 = ungültiges Format von axfr_ips
- 2308 = ungültiges Format von ns
- 2322 = Limit der Domains im DNS pro Benutzer erreicht
- 2330 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültige Konfiguration
- 2331 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültiges Format des Namens
- 2332 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültiges Format des Algorithmus
- 2333 = Ungültige Anfrage – WDNS-Domain – primäres TSIG – ungültiges Format des Schlüssels
- 2340= max. Anzahl der Domains bei einer einzelnen Aktion überschritten
- 3302 = Hinzufügen der Domain zum DNS fehlgeschlagen
- 3303 = Domain existiert im DNS bereits
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-update",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"axfr_enabled": "0 or 1",
"axfr_ips": "allowed AXFR IP address(es)",
"primary_ip": "primary IP adderess",
"primary_tsig_enabled": "0 or 1",
"primary_tsig_name": "tsig_identifier",
"primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
"primary_tsig_key": "TSIG_key_value"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-update"
}
}
JSON-Antwort für mehrere Domains (OK):
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-update",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
}
]
}
}
dns-domain-delete
Verwenden Sie dns-domain-delete Anfrage zum Löschen einer Domain aus dem DNS einschließlich aller ihrer Einträge.
Parameter
- Name – Domainname, oder mehrere durch Komma getrennte Namen (erforderlich)
Rückgabewerte
- 1000 = ok
- 2007= maximale Anfragegröße überschritten
- 2340= max. Anzahl der Domains bei einer einzelnen Aktion überschritten
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3301= Der Eintrag kann nicht entfernt werden
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-delete",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",,
"command": "dns-domain-delete"
}
}
JSON-Antwort für mehrere Domains (OK):
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-delete",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
}
]
}
}
dns-domain-axfr-run
Der dns-domain-axfr-run Anfrage aktualisiert die DNS-Einträge vom primären autoritativen Server per AXFR so schnell wie möglich (innerhalb weniger Minuten). Sie wird für sekundäre Domains verwendet, bei denen wir den Inhalt der Zone von einem anderen Server in unser System herunterladen.
Ohne diese Anfrage verwendet AXFR die Werte REFRESH und RETRY im SOA-Eintrag.
Parameter
- Name – Domainname – erforderlich
Rückgabewerte
- 1000 = ok
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 2319= kann nur beim Domaintyp sekundär ausgeführt werden
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
Rückgabedaten
- next_run – Zeitpunkt der nächsten Aktualisierung
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-axfr-run",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-axfr-run",
"data": {
"next_run": "date and time of next update"
}
}
}
dns-domain-axfr-tsig
Der dns-domain-axfr-tsig Anfrage dient zum Erstellen/Aktualisieren, Löschen oder Anzeigen der AXFR-TSIG-Schlüsselinformationen für eine oder mehrere Domains.
TSIG (Transaction Signature) ist ein Authentifizierungsmechanismus für DNS-Transfers (AXFR/IXFR), der die Identitätsprüfung zwischen primärem und sekundärem Server ermöglicht. Diese Prüfung ist für alle Transfers zu sekundären DNS-Servern erforderlich und muss exakt mit deren Konfiguration übereinstimmen.
Verwendet der primäre Server kein TSIG, aktivieren Sie diese Option nicht – der AXFR-Transfer würde fehlschlagen.
Parameter
- Name – Domainname, oder mehrere durch Komma getrennte Namen (erforderlich)
- axfr_tsig_action – AFXR-TSIG-Aktion – erforderlich
- create – AXFR TSIG aktivieren oder aktualisieren
- cancel – AXFR TSIG deaktivieren
- info – AXFR-TSIG-Informationen anzeigen
Rückgabewerte
- 1000 = ok
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 2319= kann nur beim Domaintyp sekundär ausgeführt werden
- 2334 = AXFR TSIG nicht eingestellt
- 2335 = AXFR TSIG nicht erstellt
- 2336 = AXFR TSIG nicht deaktiviert
- 2337 = ungültiger AXFR-TSIG-Befehl
- 2340 = max. Anzahl der Domains bei einer einzelnen Aktion überschritten
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
Rückgabedaten
- Name = Domainname
- axfr_tsig_action – Name der AFXR-TSIG-Aktion
- axfr_tsig_name – Name des AXFR-TSIG-Schlüssels
- axfr_tsig_alg – Algorithmus des AXFR-TSIG-Schlüssels
- axfr_tsig_key – Wert des AXFR-TSIG-Schlüssels
Vorlagen
JSON-Anfrage:
{
"request":{
"user": "your@login.tld",
"auth": "authentication string",
"command":"dns-domain-axfr-tsig",
"clTRID": "your ID",
"data":{
"name":"domain1.tld, domain2.tld",
"axfr_tsig_action":"create, cancel, or info"
}
}
}
JSON-Antwort für den Befehl create (mehrere Domain-Zustände):
{
"response":{
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-axfr-tsig",
"data": [
{
"name":"domain1.tld",
"code":1000,
"result":"OK",
"axfr_tsig_action":"create",
"axfr_tsig_name":"keyname",
"axfr_tsig_alg":"hmac-sha256",
"axfr_tsig_key":"lbOYAMGHc6eSo3R2h6rWrHcsp3iSBp/0D0S7kjRqxLI="
},
{
"name":"domain-swapi-00003y.cz",
"code":3222,
"result":"Domain open failed",
"axfr_tsig_action":"create"
}
]
}
}
dns-domain-copy
Verwenden Sie dns-domain-copy Befehl, um eine Domain zum DNS hinzuzufügen, indem Sie Einstellungen und Einträge von einer anderen bestehenden Domain kopieren.
Parameter
- Name – Name der ursprünglichen Domain (die Sie kopieren möchten) – erforderlich
- name_new – Name der neu angelegten Domain – erforderlich
Rückgabewerte
- 1000 = ok
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Name der bestehenden Domain
- 2320= ungültiger oder nicht unterstützter Name der neuen Domain
- 2321= nicht unterstützte TLD des neuen Domainnamens
- 2322= Limit der Anzahl der Domains im DNS pro Benutzer erreicht
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
- 3311= Kopieren fehlgeschlagen
- 3312= die neue Domain existiert im DNS bereits
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-copy",
"clTRID": "your ID",
"data": {
"name": "original domain name",
"name_new": "new domain name"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-copy"
}
}
dns-domain-commit
Verwenden Sie dns-domain-commit Anfrage nach jeder Änderung an der Domain oder ihren DNS-Einträgen. Sie bestätigen die Änderungen und beantragen deren Verteilung an die DNS-Server.
Wenn Sie nicht ausführen dns-domain-commit Befehl, führt das System ihn 5 Minuten nach der letzten Änderung automatisch aus.
Parameter
- Name – Domainname – erforderlich
Rückgabewerte
- 1000 = ok
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-commit",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-commit"
}
}
dns-rows-list
Verwenden Sie dns-rows-list Anfrage zum Abrufen einer Liste der Domaineinträge im DNS samt grundlegender Informationen.
Um detailliertere Informationen zu einem bestimmten Eintrag zu erhalten, verwenden Sie dns-row-detail Anfrage.
Parameter
- domain – Domainname – erforderlich
Rückgabewerte
- 1000 = ok
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 2318= kann beim Domaintyp sekundär nicht ausgeführt werden
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
Antwortdaten
- Zeile – Eintrag
- ID – ID des Eintrags
- Name – Name des Eintrags
- ttl – TTL des Eintrags
- rdtype – Typ des Eintrags
- rdata – Daten des Eintrags
- changed_date – Datum der Änderung
- author_comment – Kommentar
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-rows-list",
"clTRID": "your ID",
"data": {
"domain": "domain name"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-rows-list",
"data": {
"row1": {
"ID": "record ID",
"name": "record name (may be empty)",
"ttl": "TTL",
"rdtype": "record type",
"rdata": "record data",
"changed_date": "date and time of last update",
"author_comment": "comment"
}
}
}
}
dns-row-detail
Der dns-row-detail Anfrage gibt detaillierte Informationen zu einem bestimmten DNS-Eintrag der Domain zurück.
Um eine vollständige Liste der Einträge einer Domain zu erhalten, verwenden Sie dns-rows-list Anfrage.
Parameter
- Name – Domainname – erforderlich
- row_id – ID des Eintrags – erforderlich, ermittelt aus dns-rows-list
Rückgabewerte
- 1000 = ok
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 2318= Diese Aktion kann beim Domaintyp sekundär nicht ausgeführt werden
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
- 3309= Der erforderliche DNS-Eintrag für die Domain existiert nicht
Rückgabedaten
- Zeile – Eintrag
- ID – ID des Eintrags
- Name – Name des Eintrags
- ttl – TTL des Eintrags
- rdtype – Typ des Eintrags
- rdata – Daten des Eintrags
- changed_date – Datum der Änderung
- author_comment – Kommentar
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-detail",
"clTRID": "your ID",
"data": {
"name": "název domény",
"row_id": "ID záznamu"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-detail",
"data": {
"row1": {
"ID": "record ID",
"name": "record name (may be empty)",
"ttl": "TTL",
"rdtype": "record type",
"rdata": "record data",
"changed_date": "date and time of last update",
"author_comment": "comment"
}
}
}
}
dns-row-add
Der dns-row-add Anfrage fügt der Domain einen neuen DNS-Eintrag hinzu.
Parameter
- domain – Domainname – erforderlich
- Name – Name des Eintrags – erforderlich, darf aber leer sein
- ttl – TTL-Wert – erforderlich
- Typ – Typ des Eintrags – erforderlich
- rdata – Daten des Eintrags – erforderlich
- author_comment – Kommentar des Autors – optional. Das Senden einer leeren Zeichenkette löscht den vorherigen Kommentar.
Rückgabewerte
- 1000 = ok
- 2100 = erforderlicher Parameter fehlt
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 2309= ungültiger Eintragstyp
- 2310= Der Domain kann kein weiterer Eintrag hinzugefügt werden
- 2311= ungültiger Name
- 2312= ungültiger Name für diesen Eintragstyp
- 2313= ungültiger CNAME für diesen Namen
- 2314= ungültige Daten des Eintrags
- 2315= ungültige TLD
- 2316= Dieser Eintrag existiert bereits
- 2317= ungültige TTL
- 2318= Die Aktion kann beim Domaintyp sekundär nicht ausgeführt werden
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
- 3307 = Hinzufügen des Domaineintrags fehlgeschlagen
- 5001 = interner Authentifizierungsfehler
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-add",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"name": "record name (may be empty)",
"ttl": "TTL",
"type": "record type",
"rdata": "record data"
}
}
}
JSON-Anfrage (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-add",
}
}
dns-row-update
Verwenden Sie dns-row-update Anfrage zum Ändern eines DNS-Eintrags.
Den Namen und den Typ eines Eintrags können Sie nicht ändern. In einer solchen Situation den ursprünglichen Eintrag löschen und dann ein neues erstellen.
Parameter
- domain – Domainname – erforderlich
- row_id – ID des Eintrags – erforderlich, ermittelt aus dns-rows-list
- ttl – TTL-Wert – erforderlich
- rdata – Daten des Eintrags – erforderlich
- author_comment – Kommentar des Autors – optional. Das Senden einer leeren Zeichenkette löscht den vorherigen Kommentar.
Rückgabewerte
- 1000 = ok
- 2100 = erforderlicher Parameter fehlt
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 2309= ungültiger Eintragstyp
- 2310= Der Domain kann kein weiterer Eintrag hinzugefügt werden
- 2311= ungültiger Name
- 2312= ungültiger Name für diesen Eintragstyp
- 2313= ungültiger CNAME für diesen Namen
- 2314= ungültige Daten des Eintrags
- 2315= ungültige TLD
- 2316= Dieser Eintrag existiert bereits
- 2317= ungültige TTL
- 2318= Die Aktion kann beim Domaintyp sekundär nicht ausgeführt werden
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
- 3310 = Aktualisierung des Domaineintrags fehlgeschlagen
- 5001 = interner Authentifizierungsfehler
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Befehl:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-update",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "row ID",
"ttl": "TTL",
"rdata": "record data"
}
}
}
JSON-Antwort (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-update"
}
}
dns-row-delete
Verwenden Sie dns-row-delete Anfrage zum Löschen eines DNS-Eintrags einer Domain.
Parameter
- domain – Domainname – erforderlich
- row_id – ID des Eintrags – erforderlich, ermittelt aus dns-rows-list
Rückgabewerte
- 1000 = ok
- 2201= nicht unterstützte TLD
- 2202= ungültiger oder nicht unterstützter Domainname
- 2318= ungültige Aktion für den Domaintyp sekundär
- 3222= Öffnen der Domain fehlgeschlagen
- 3223= Zugriff verweigert
- 3305= Domain ist für die Bearbeitung gesperrt
- 3306= Domain ist gelöscht
- 3308= Löschen des Eintrags fehlgeschlagen
- 3309= Ein Eintrag mit dieser ID existiert nicht
Rückgabedaten
Die Anfrage liefert keine Daten zurück.
Vorlagen
JSON-Anfrage:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-delete",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "record ID"
}
}
}
JSON-Anfrage (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-delete",
}
}
War das hilfreich?
Danke für Ihr Feedback!