WAPI - NSSET

Dieser Artikel enthält Informationen zu den folgenden Anträgen:

• nsset-check - NSSET-Verfügbarkeitsprüfung
• nsset-info - NSSET-Informationen
• nsset-create - NSSET erstellen
• nsset-update - NSSET aktualisieren
• nsset-transfer - NSSET von einer anderen Registrierstelle übertragen
• nsset-send-auth-info - NSSET AUTH-ID senden

---

nsset-check

Verwenden Sie die Anfrage nsset-check, um zu prüfen, ob der NSSET-Name frei zur Registrierung ist oder sich in einem anderen Zustand befindet.

Parameter

• tld - Bereich TLD
• name - NSSET-Name

Rückgabewerte

• 1000 = NSSET ist für die Registrierung verfügbar
• 2201 = ungültige TLD
• 2247 = nicht unterstütztes NSSET-Format
• 3242 = NSSET ist nicht verfügbar
• 3245 = NSSET ist bereits registriert
• 3246 = nicht verfügbar
• 3247 = nicht verfügbar
• 3248 = nicht verfügbar - Quarantäne
• 3249 = nicht verfügbar - reserviert
• 3250 = nicht verfügbar - gesperrt
• 3251 = bereits registriert (bei uns)
• 4218 = Senden fehlgeschlagen - Kommunikationsfehler

Daten zurücksenden

Die Anfrage liefert keine Daten.

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-check",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-check"
  }
}

---

nsset-info

Verwenden Sie die nsset-info-Anfrage, um Informationen über einen NSSET herunterzuladen.

Parameter

• tld - TLD
• name - NSSET-Name

Rückgabewerte

• 1000 = OK
• 2201 = ungültige TLD
• 2209 = Syntaxfehler
• 2247 = nicht unterstütztes NSSET-Format 
• 3214 = Fehler - NSSET nicht geladen
• 3242 = NSSET ist nicht verfügbar
• 4204 = Verbindungsfehler, später erneut versuchen

Daten zurücksenden

Bei Erfolg gibt die Anfrage ein nsset-Element im Datenknoten mit den folgenden Einträgen zurück:

• name - NSSET-Name
• Status - Status
• reg_owner - aktueller Registrator
• reg_creator - NSSET-Ersteller (Registrator)
• reg_update - Registrar, der die letzte Aktualisierung vorgenommen hat
• created_date - Datum der Erstellung
• updated_date - Datum der letzten Aktualisierung
• transfer_date - Datum der Übertragung an eine andere Registrierstelle
• tech_c - Technischer Ansprechpartner für NSSET
• dns - DNS-Server-Liste
• Server
  • name - Name des Servers
  • addr_ipv4 - IPv4-Serveradresse
  • addr_ipv6 - IPv6-Serveradresse

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-info",
    "data": {
      "nsset": {
        "name": "NSSET name",
        "status": "status",
        "reg_owner": "current registrar",
        "reg_creator": "NSSET creator (registrar)",
        "reg_update": "last update registrar",
        "created_date": "date and time of creation",
        "updated_date": "date and time of last update",
        "transfer_date": "date and time of last transfer",
        "tech_c": "technical contact ID",
        "dns": {
          "server1": {
            "name": "DNS server name",
            "addr_ipv4": "DNS server IPv4",
            "addr_ipv6": "DNS server IPv6"
          }
        }
      }
    }
  }
}

nsset-create

Verwenden Sie die Anforderung nsset-create, um ein neues NSSET zu erstellen. Das NSSET enthält eine Liste von NS-Servern, wobei jeder Server einen Namenseintrag und möglicherweise auch seine IP-Adresse enthält. Sie können auch einen technischen Kontakt festlegen - wenn Sie dies nicht tun, wird der Standard (WEDOS) festgelegt.

Parameter

• tld - TLD
• name - NSSET-Name
• dns - Liste der ns-Server, jeder Servereintrag enthält Informationen über diesen ns-Server
  • Server
    • name - Name (Domänenadresse)
    • addr_ipv4 - IPv4-Adresse
    • addr_ipv6 - IPv6-Adressierung
• tech_c - technischer Kontakt - fakultativ

Rückgabewerte

• 1000 = OK, NSSET erstellt
• 2201 = falsche TLD eingegeben
• 2210 = ungültiges Format der ns-Server
• 2211 = zu viele ns-Server
• 2216 = ungültige Syntax im technischen Kontakt 
• 2247 = nicht unterstütztes NSSET-Format 
• 3228 = keine Unterstützung für die Arbeit mit Kontakten
• 3229 = Fehler beim Laden des Kontakts
• 3242 = NSSET ist nicht verfügbar
• 3244 = NSSET-Erstellung fehlgeschlagen
• 3245 = NSSET ist bereits registriert
• 3246 = nicht verfügbar
• 3247 = nicht verfügbar
• 3248 = nicht verfügbar - Quarantäne
• 3249 = nicht verfügbar - reserviert
• 3250 = nicht verfügbar - gesperrt
• 3251 = bereits registriert
• 4212 = Verbindungsfehler
• 4218 = Prüfung fehlgeschlagen - Kommunikationsfehler
• 4219 = Erstellung fehlgeschlagen - Kommunikationsfehler

Daten zurücksenden

Bei Erfolg wird der Befehl im Datenknoten zurückgegeben:

• nsset - der erstellte NSSET-Name

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-create",
    "clTRID": "your ID",,
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "dns": {
        "server1": {
          "name": "DNS server name",
          "addr_ipv4": "DNS server IPv4 address",
          "addr_ipv6": "DNS server IPv6 address"
        }
      },
      "tech_c": "technical contact ID"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-create",
    "data": {
      "nsset": "NSSET name"
    }
  }
}

---

nsset-update

Verwenden Sie die Anfrage nsset-update, um einen bestehenden NSSET zu ändern. Der alte Eintrag wird vollständig überschrieben, geben Sie daher alle Daten sorgfältig ein.

Parameter

• tld - TLD
• name - NSSET-Name
• dns - Liste der ns-Server, jeder Servereintrag enthält Informationen über diesen ns-Server
  • Server
    • name - Domänenname des Servers
    • addr_ipv4 - IPv4-Adresse
    • addr_ipv6 - IPv6-Adresse
• tech_c - ID des technischen Kontakts - optional

Rückgabewerte

• 1000 = OK, NSSET geändert
• 2201 = falsche TLD eingegeben
• 2209 = Syntaxfehler
• 2210 = Ungültiges Format der Liste der DNS-Server
• 2211 = zu viele DNS-Server
• 2216 = ungültige Syntax im Kontakt
• 2247 = ungültiger NSSET
• 3214 = Fehler - NSSET nicht geladen
• 3228 = keine Unterstützung für die Arbeit mit Kontakten
• 3229 = Fehler beim Laden des Kontakts
• 3242 = NSSET wird für diese Domäne nicht unterstützt 
• 3252 = Autorisierungsfehler
• 3254 = NSSET-Änderung fehlgeschlagen nsset
• 4204 = NSSET ist nicht verfügbar - Verbindungsfehler
• 4220 = NSSET-Änderung fehlgeschlagen - Verbindungsfehler
• 4212 = Kontakt ist nicht verfügbar - Verbindungsfehler

Daten zurücksenden

Die Anfrage liefert keine Daten.

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-update",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "dns": {
        "server1": {
          "name": "DNS server name",
          "addr_ipv4": "DNS server IPv4 address",
          "addr_ipv6": "DNS server IPv6 address"
        }
      },
      "tech_c": "technical contact ID"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-update"
  }
}

---

nsset-übertragung

Die nsset-transfer-Anforderung ändert den NSSET-Registrar in WEDOS.

Parameter

• tld - TLD
• name - NSSET-Name
• auth_info - NSSET AUTH-ID

Rückgabewerte

• 1000 = OK
• 2100 = der erforderliche Parameter fehlt
• 2101 = ungültige Eingabeparameter
• 2201 = nicht unterstützte TLD
• 2209 = Syntaxfehler
• 2215 = fehlende auth_info
• 2247 = ungültiger NSSET-Name 
• 2249 = NSSET-Übertragung ist für diese TLD nicht erlaubt
• 3214 = Fehler - NSSET nicht geladen
• 3242 = NSSET nicht unterstützt
• 3251 = NSSET ist bereits bei dieser Registrierstelle registriert 
• 3255 = Autorisierungsfehler
• 3256 = NSSET-Übertragung fehlgeschlagen
• 4204 = NSSET nicht geladen - Verbindungsfehler
• 4221 = NSSET-Übertragung fehlgeschlagen - Verbindungsfehler

Daten zurücksenden

Die Anfrage liefert keine Daten.

Schablonen

JSON-Befehl:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-transfer",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "auth_info": "NSSET AUTH-ID"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-transfer"
  }
}

---

nsset-send-auth-info

Die nsset-send-auth-info-Anfrage sendet die NSSET AUTH-ID an die E-Mail-Adresse des technischen Kontakts von NSSET.

Parameter

• tld - TLD
• name - NSSET-Name

Rückgabewerte

• 1000 = OK, auth_info an die Kontakt-E-Mail gesendet
• 2201 = nicht unterstützte TLD
• 2209 = NSSET-Syntaxfehler
• 2216 = Kontakt-Syntaxfehler
• 2243 = für diesen NSSET ist es nicht erlaubt, den Autorisierungscode zu senden
• 2247 = nicht unterstütztes NSSET-Format
• 3214 = Fehler - NSSET-Lesen fehlgeschlagen
• 3217 = Senden des Autorisierungscodes fehlgeschlagen
• 3228 = unterstützt die Arbeit mit Kontakten nicht
• 3229 = Kontakt lesen fehlgeschlagen
• 3242 = NSSET ist nicht verfügbar
• 3257 = Senden fehlgeschlagen, NSSET ist nicht verfügbar
• 4204 = NSSET ist nicht verfügbar - Verbindung fehlgeschlagen
• 4212 = Kontakt ist nicht verfügbar - Verbindung fehlgeschlagen
• 4222 = Senden fehlgeschlagen - Verbindung fehlgeschlagen

Daten zurücksenden

Die Anfrage liefert keine Daten.

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-send-auth-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-send-auth-info"
  }
}