WAPI – NSSET

Dieser Artikel enthält Informationen zu den folgenden Requests:

• nsset-check – Prüfung der Verfügbarkeit eines NSSET
• nsset-info – Informationen zum NSSET
• nsset-create – NSSET anlegen
• nsset-update – NSSET ändern
• nsset-transfer – NSSET von einem anderen Registrar transferieren
• nsset-send-auth-info – AUTH-ID des NSSET senden

---

nsset-check

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

Parameter

• tld – TLD der Domain
• name – Name des NSSET

Rückgabewerte

• 1000 = NSSET ist zur 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 – blockiert
• 3251 = bereits registriert (bei uns)
• 4218 = Senden fehlgeschlagen – Kommunikationsfehler

Rückgabedaten

Der Request gibt keine Daten zurück.

Vorlagen

JSON-Request:

{
  "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 den nsset-info Request, um Informationen über ein NSSET abzurufen.

Parameter

• tld – TLD
• name – Name des NSSET

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, versuchen Sie es später erneut

Rückgabedaten

Bei Erfolg gibt der Request im Knoten data ein Element nsset mit den folgenden Einträgen zurück:

• name – Name des NSSET
• status – Status
• reg_owner – aktueller Registrar
• reg_creator – Ersteller des NSSET (Registrar)
• reg_update – Registrar, der die letzte Änderung vorgenommen hat
• created_date – Datum der Erstellung
• updated_date – Datum der letzten Änderung
• transfer_date – Datum des Transfers zu einem anderen Registrar
• tech_c – technischer Kontakt des NSSET
• dns – Liste der DNS-Server
• server
  • name – Name des Servers
  • addr_ipv4 – IPv4-Adresse des Servers
  • addr_ipv6 – IPv6-Adresse des Servers

Vorlagen

JSON-Request:

{
  "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 den nsset-create Request, um ein neues NSSET anzulegen. Das NSSET enthält eine Liste von NS-Servern, jeder Server enthält einen Namenseintrag und gegebenenfalls auch seine IP-Adresse. Sie können auch einen technischen Kontakt festlegen – wenn Sie das nicht tun, wird der Standardkontakt (WEDOS) gesetzt.

Parameter

• tld – TLD
• name – Name des NSSET
• dns – Liste der NS-Server, jeder Servereintrag enthält Informationen über diesen NS-Server
  • server
    • name – Name (Domain-Adresse)
    • addr_ipv4 – IPv4-Adresse
    • addr_ipv6 – IPv6-Adresse
• tech_c – technischer Kontakt – optional

Rückgabewerte

• 1000 = OK, NSSET angelegt
• 2201 = falsche TLD eingegeben
• 2210 = ungültiges Format der NS-Server
• 2211 = zu viele NS-Server
• 2216 = ungültige Syntax des technischen Kontakts 
• 2247 = nicht unterstütztes NSSET- Format 
• 3228 = Arbeiten mit Kontakten wird nicht unterstützt
• 3229 = Fehler beim Laden des Kontakts
• 3242 = NSSET ist nicht verfügbar
• 3244 = Anlegen des NSSET 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 – blockiert
• 3251 = bereits registriert
• 4212 = Verbindungsfehler
• 4218 = Prüfung fehlgeschlagen – Kommunikationsfehler
• 4219 = Anlegen fehlgeschlagen – Kommunikationsfehler

Rückgabedaten

Bei Erfolg gibt der Befehl im Knoten data zurück:

• nsset – Name des angelegten NSSET

Vorlagen

JSON-Request:

{
  "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 den nsset-update Request, um ein bestehendes NSSET zu ändern. Der alte Eintrag wird vollständig überschrieben, geben Sie daher alle Daten sorgfältig ein.

Parameter

• tld – TLD – erforderlich
• auth_info – AUTH-ID des NSSET – erforderlich
• name – Name des NSSET – erforderlich
• dns – Liste der NS-Server, jeder Servereintrag enthält Informationen über diesen NS-Server – erforderlich
  • server – mindestens 2 erforderlich
    • name – Domainname des Servers – erforderlich
    • addr_ipv4 – IPv4-Adresse – optional
    • addr_ipv6 – IPv6-Adresse – optional
• tech_c – ID des technischen Kontakts – erforderlich

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 des Kontakts
• 2247 = ungültiges NSSET
• 3214 = Fehler – NSSET nicht geladen
• 3228 = Arbeiten mit Kontakten wird nicht unterstützt
• 3229 = Fehler beim Laden des Kontakts
• 3242 = NSSET wird für diese Domain nicht unterstützt 
• 3252 = Autorisierungsfehler
• 3254 = Änderung des NSSET fehlgeschlagen nsset
• 4204 = NSSET ist nicht verfügbar – Verbindungsfehler
• 4220 = Änderung des NSSET fehlgeschlagen – Verbindungsfehler
• 4212 = Kontakt ist nicht verfügbar – Verbindungsfehler

Rückgabedaten

Der Request gibt keine Daten zurück.

Vorlagen

JSON-Request:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-update",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "auth_info": "NSSET AUTH-ID",
      "dns": {
        "server1": {
          "name": "DNS server name"
        },
        "server2": {
          "name": "DNS server name"
        }
      },
      "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-transfer

Der nsset-transfer Request ändert den Registrar des NSSET zu WEDOS.

Parameter

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

Rückgabewerte

• 1000 = OK
• 2100 = erforderlicher Parameter fehlt
• 2101 = ungültige Eingabeparameter
• 2201 = nicht unterstützte TLD
• 2209 = Syntaxfehler
• 2215 = fehlende auth_info
• 2247 = ungültiger Name des NSSET 
• 2249 = Der Transfer des NSSET ist  für diese TLD nicht erlaubt
• 3214 = Fehler – NSSET nicht geladen
• 3242 = NSSET wird nicht unterstützt
• 3251 = NSSET ist bei diesem Registrar bereits registriert 
• 3255 = Autorisierungsfehler
• 3256 = Transfer des NSSET fehlgeschlagen
• 4204 = NSSET nicht geladen – Verbindungsfehler
• 4221 = Transfer des NSSET fehlgeschlagen – Verbindungsfehler

Rückgabedaten

Der Request gibt keine Daten zurück.

Vorlagen

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

Der nsset-send-auth-info Request sendet die AUTH-ID des NSSET an die E-Mail-Adresse des technischen Kontakts des NSSET.

Parameter

• tld – TLD
• name – Name des NSSET

Rückgabewerte

• 1000 = OK, auth_info an die E-Mail-Adresse des Kontakts gesendet
• 2201 = nicht unterstützte TLD
• 2209 =  Syntaxfehler des NSSET
• 2216 = Syntaxfehler des Kontakts
• 2243 = Für dieses NSSET ist das Senden des Autorisierungscodes nicht erlaubt
• 2247 = nicht unterstütztes NSSET-Format
• 3214 = Fehler – Lesen des NSSET fehlgeschlagen
• 3217 = Senden des Autorisierungscodes fehlgeschlagen
• 3228 = Arbeiten mit Kontakten wird nicht unterstützt
• 3229 = Lesen des Kontakts 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

Rückgabedaten

Der Request gibt keine Daten zurück.

Vorlagen

JSON-Request:

{
  "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"
  }
}