WAPI - Domänen

Dieser Artikel befasst sich mit WAPI-Befehlen speziell für den WEDOS-DNS-Dienst. Informationen zur Einrichtung von WAPI und zur Fehlerbehebung bei allgemeinen Problemen finden Sie im Artikel WAPI - Handbuch.

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

Domänen-Liste

Die Abfrage domains-list liefert eine Liste aller Domains im Kundenkonto und deren Status. Sie gibt auch die Namen von gelöschten Domains zurück. Wenn einer Domäne mehr als ein Auftrag zugewiesen wurde, gibt die Abfrage sie mehrfach mit dem entsprechenden Status (z. B. "gelöscht") zurück.

Parameter

  • Status - Filter nach Status (optional)

Zu den üblichen Domänenzuständen gehören:

  • fee_waiting - in Erwartung einer Zahlung
  • setup_processing - Erstellung in Arbeit
  • aktiv
  • renew_processing - Erneuerung in Bearbeitung
  • Abgelaufen
  • deaktiviert
  • gestrichen
  • transfer_fee_waiting - wartet auf Überweisung
  • transfer_processing - Übertragung von einer anderen Registrierstelle in Bearbeitung
  • gelöscht

Rückgabewerte

  • 1000 - OK

Antwortdaten

Der Befehl domains-list gibt eine Liste von Domänen zurück, in der jede Domäne die folgenden Einträge enthält:

  • name - Domänenname
  • status - Status der Domäne

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domains-list",
    "clTRID": "your ID",
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domains-list",
    "data": {
      "domain": {
        "1": {
          "name": "domain1.tld",
          "status": "status"
         },
         "0": {
          "name": "domain2.tld",
          "status": "status"
        }
      }
    }
  }
}

domain-check

Verwenden Sie den Domain-Check-Auftrag, um zu überprüfen, ob wir eine Domain registrieren können.

Der Domain-Check-Requset unterliegt dem Limit von 100 Domainabfragen pro Stunde.

Einige Domains können wir nicht registrieren, obwohl sie derzeit nicht existieren. Die Namen können reserviert oder gesperrt sein, oder ihre Registrierung kann auf andere Weise eingeschränkt sein. Das hängt immer von der jeweiligen Registrierungsstelle, ihren Regeln oder laufenden Streitigkeiten ab.

Parameter

  • name - Domänenname ohne www - erforderlich

Rückgabewerte

  • 1000 - Domain ist zur Registrierung verfügbar
  • 3201 - Domänenname wird bereits verwendet
  • 3204 - Domäne wird unter Quarantäne gestellt
  • 3205 - Domäne ist reserviert
  • 3206 - Domänenname ist blockiert

Antwortdaten

Diese Anfrage liefert außer dem Rückgabewert keine weiteren Daten.

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-check",
    "clTRID": "your ID",
    "data": {
      "name": "your domain without www"
    }
  }
}

JSON-Antwort (OK):

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

domain-create

Verwenden Sie den Antrag "domain-create", um eine neue Domäne zu registrieren. Die Anfrage ist entweder synchron oder asynchron, abhängig von der Domänen-TLD.

Für die Domain-Erstellung gilt ein Limit von 100 Domain-Abfragen pro Stunde.

Für alle Domains benötigen wir und die Registrierungsstelle die Zustimmung des Domaininhabers zu den Registrierungsregeln für Domainnamen. Unsere Bedingungen verlangen von Ihnen, dass Sie Ihre Kunden mit unseren Bedingungen und den Bedingungen des Domain-Registrars vertraut machen! Andernfalls kann die Domain im Streitfall entschädigungslos gelöscht werden.

Parameter

  • name - Domänenname einschließlich TLD - erforderlich
  • Zeitraum - Anzahl der Jahre - erforderlich
  • dns oder nsset - eine Liste von DNS-Servern oder NSSET (nur CZ-Domänen) - erforderlich
  • owner_c - Kontakt-ID des Eigentümers - erforderlich
  • admin_c - Administrator-Kontakt-ID - optional
  • Regeln - Vor- und Nachname der Person, die unseren Bedingungen und den Bedingungen des Registers zugestimmt hat (in der Regel der Domaininhaber)

Mögliche dns-Parameterwerte:

  • Leerer dns-Parameterwert - Standardwert verwenden (WEDOS DNS-Server). Achtung, auch wenn Sie den DNS-Parameter leer lassen, müssen Sie ihn trotzdem angeben! Der NSSET-Parameter muss immer einen Wert enthalten (z. B. WEDOS).
  • Eigene DNS-Konfiguration - kann nicht für CZ-Domains verwendet werden (jeder Datensatz muss ein Namensfeld enthalten, optional addr_ip4 und addr_ip6, einzelne Server sind im Server-Element verschachtelt). Siehe Vorlage für Details.

Rückgabewerte

  • 1000 - Domain wurde erfolgreich registriert
  • 1001 - asynchrone Registrierungsanfrage akzeptiert
  • 3002 - unzureichendes Guthaben auf dem Kreditkonto
  • 3201 - Domänenname wird bereits verwendet
  • 3204 - Domäne wird unter Quarantäne gestellt
  • 3205 - Domäne ist reserviert
  • 3206 - Domänenname ist blockiert
  • 2201 - nicht unterstützte TLD
  • 2203 - ungültiger Zeitraum
  • 3221 - Erstellung fehlgeschlagen
  • 4207 - Erstellung fehlgeschlagen - Verbindungsfehler

Antwortdaten

Nach erfolgreicher Domänenregistrierung werden die folgenden Elemente im Datenknoten zurückgegeben:

  • num - Bestellnummer
  • Ablauf - Ablaufdatum der Domäne
  • Kredit - Status des Guthabenkontos nach Abschluss des Vorgangs
    • Betrag - Kontoguthaben
    • Währung - Währung

Schablonen

JSON-Anfrage mit WEDOS NSSET:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-create",
    "clTRID": "your ID",
    "data": {
      "name": "domain.cz",
      "period": "number of years",
      "nsset": "WEDOS",
      "owner_c": "owner contact ID",
      "admin_c": "admin contact ID",
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
    }
  }
}

JSON-Anfrage mit eigenem DNS:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-create",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "period": "number of years",
      "dns": {
        "server1":
          {
            "name": "ns1.dns-provider.tld"
          },
        "server2":
          {
            "name": "ns2.dns-provider.tld"
          }
        }
      },
      "owner_c": "domain owner contact ID",
      "admin_c": "domain admin contact ID",
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-create",
    "data": {
      "num": "order number",
      "expiration": "YYYY-MM-DD"
    }
  }
}

domain-info

Verwenden Sie die domain-info-Abfrage, um Informationen über eine bestimmte Domain zu erhalten.

Der Befehl funktioniert nur für Domains im entsprechenden Kundenkonto.

Parameter

  • name - Domänenname ohne www - erforderlich

Rückgabewerte

  • 1000 - Befehl war erfolgreich, Elementdaten enthalten Informationen über Domain
  • 3222 - Abruf des Domänenobjekts fehlgeschlagen 
  • 3216 - Informationen über die Domäne konnten nicht abgerufen werden
  • 3223 - Domain gehört nicht zu Ihrem Kundenkonto
  • 4205 - Fehler im Zusammenhang mit der Registrierung

Antwortdaten

Das Datenelement enthält Informationen über die Domäne im Erfolgsfall. Die spezifischen Daten hängen von der Art der Domäne und anderen Umständen ab. Hier sind die wichtigsten davon:

  • name - Domänenname
  • status - Status der Domäne
  • owner_c - ID des Domänenbesitzers
  • setup_date - Datum der Erstellung
  • Verfallsdatum - Verfallsdatum
  • dns oder NSSET - Liste der DNS-Server oder NSSET
  • Elemente mit Präfix own_ - Informationen zum Domänenbesitzer

Einige Informationen über die Domäne oder ihren Inhaber können verborgen sein; in diesem Fall haben sie den Wert HIDDEN.

Schablonen

JSON-Anfrage:

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

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-info",
    "data": {
      "domain": {
        "name": "domain.tld",
        "status": "status",
        "owner_c": "owner ID",
        "nsset": "WEDOS",
        "reg_owner": "",
        "reg_creator": "",
        "setup_date": "YYYY-MM-DD",
        "expiration": "YYYY-MM-DD",
        "reg_update": "",
        "updated_date": "",
        "transfer_date": "",
        "dns": {
          "server1":
            {
              "name": "ns1.server-provider.tld"
            },
          "server2":
            {
              "name": "ns1.server-provider.tld"
            }
          }
        },
        "own_company": "",
        "own_name": "",
        "own_lname": "",
        "own_fname": "",
        "own_email": "",
        "own_email2": "",
        "own_phone": "",
        "own_fax": "",
        "own_ic": "",
        "own_dic": "",
        "own_taxpayer": "",
        "own_addr_street": "",
        "own_addr_city": "",
        "own_addr_zip": "",
        "own_addr_country": "",
        "own_addr_state": "",
        "admin_c": "",
        "own_other": {
          "notify_email": "",
          "ident_type": "",
          "ident": ""
        }
      }
    }
  }
}

domain-renew

Mit dem Antrag auf Domain-Verlängerung können Sie eine Domain verlängern, für die noch keine Verlängerung bestellt wurde.

Das System versucht automatisch, Domains 30 Tage vor Ablauf zu verlängern.

Parameter

  • name - Domänenname - erforderlich
  • Zeitraum - Anzahl der zu verlängernden Jahre - erforderlich

Rückgabewerte

  • 1000 - Die Domain wurde erfolgreich verlängert
  • 2203 - Ungültiger Verlängerungszeitraum
  • 2269 - Verlängerungsantrag bereits vorhanden

Antwortdaten

Bei Erfolg gibt dieser Befehl das neue Verfallsdatum zurück.

  • Ablauf - Ablaufdatum der neuen Domäne

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-renew",
    "clTRID": "your ID",
    "data": {
      "name": "your domain name without www",
      "period": "number of years"
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-renew",
    "data": {
      "expiration": "YYYY-MM-DD"
    }
  }
}

domain-update-ns

Verwenden Sie die Anforderung domain-update-ns, um die DNS-Server oder NSSET der Domäne zu ändern.

Parameter

  • name - Domänenname - erforderlich
  • dns oder nsset - DNS-Server oder NSSET für CZ-Domänen - erforderlich

Mögliche dns-Parameterwerte:

  • Leerer dns-Parameterwert - Standardwert verwenden (WEDOS DNS-Server). Achtung, auch wenn Sie den DNS-Parameter leer lassen, müssen Sie ihn trotzdem angeben! Der NSSET-Parameter muss immer einen Wert enthalten (z. B. WEDOS).
  • Eigene DNS-Konfiguration - kann nicht für CZ-Domains verwendet werden (jeder Datensatz muss ein Namensfeld enthalten, optional addr_ip4 und addr_ip6, einzelne Server sind im Server-Element verschachtelt). Siehe Vorlage für Details.

Rückgabewerte

  • 1000 - DNS-Server erfolgreich eingestellt 
  • 2209 - ungültiges NSSET-Format (für CZ-Domänen)
  • 2210 - Ungültiges DNS-Serverformat

Antwortdaten

Die Anfrage liefert keine Daten.

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-update-ns",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "dns": {
        "server1":
          {
            "name": "ns1.own-dns-server.tld"
          },
        "server2":
          {
            "name": "ns1.own-dns-server.tld"
          }
        }
      }
    }
  }  
}

JSON-Antwort (OK):

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

domain-transfer-check

Verwenden Sie den Domain-Transfer-Check-Auftrag, um zu prüfen, ob die Domain von einem anderen Registrar zu uns transferiert werden kann.

Die Domain-Übertragungsprüfung unterliegt dem Limit von 100 Domainabfragen pro Stunde.

Parameter

  • name - Domänenname ohne www - erforderlich

Rückgabewerte

Die Anfrage gibt in der Regel die folgenden Werte zurück:

  • 1000 - Übertragung ist möglich
  • 3217 - Verbindung mit der Registratur konnte nicht hergestellt werden
  • 3218 - Übertragung ist nicht möglich

Antwortdaten

Die Anfrage liefert keine Daten.

Schablonen

JSON-Anfrage:

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

JSON odpověď (OK):

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

Domain-Transfer

Verwenden Sie den Domain-Transferauftrag, um eine Domain von einem anderen Registrar zu WEDOS zu übertragen.

Die Anfrage ist nur für CZ- und EU-Domains synchron, d.h. für diese wird bei korrekter AUTH-ID der Transfer sofort durchgeführt und Sie erfahren das Ergebnis sofort. Für andere Domains sind die Übertragungen asynchron, d.h. Sie erfahren das Ergebnis durch eine Benachrichtigung.

Die Website Domain-Übertragung unterliegt der Beschränkung auf 100 Domainabfragen pro Stunde.

Für alle Domains benötigen wir und die Registrierungsstelle die Zustimmung des Domaininhabers zu den Registrierungsregeln für Domainnamen. Unsere Bedingungen verlangen von Ihnen, dass Sie Ihre Kunden mit unseren Bedingungen und den Bedingungen des Domain-Registrars vertraut machen! Andernfalls kann die Domain im Streitfall entschädigungslos gelöscht werden.

Parameter

  • name - Domänenname ohne www - erforderlich
  • auth_info - Bereich AUTH-ID - erforderlich
  • owner_c - ID des Domäneninhabers - nur für einige Register erforderlich (SK, EU, gTLD)
  • dns - Konfiguration des DNS-Servers der Domäne - optional; nur für Registrierungsstellen verfügbar, die dies unterstützen (EU, gTLD)
  • Regeln - Vor- und Nachname der Person, die unseren Bedingungen und den Bedingungen der Registrierungsstelle zugestimmt hat (in der Regel der Domaininhaber) - erforderlich

Verfügbare Werte für den Parameter dns:

  • DNS-Parameter weggelassen - die Domain behält die aktuellen DNS-Server-Einstellungen bei. Während des Transfers werden die aktuellen DNS-Server aufgelöst. Wenn es nicht möglich ist, die aktuellen DNS-Server aufzulösen, kann die Übertragung zu einem Fehler führen (gTLD).
  • Leerer DNS-Parameter - das System versucht, die Standard-WEDOS-DNS-Server einzustellen.
  • DNS-Parameter mit Servern - das System wird versuchen, diese DNS-Server zu setzen.

Rückgabewerte

  • 1000 - Domain erfolgreich übertragen
  • 1001 - Überweisungsantrag wurde angenommen, Umsetzung steht noch aus
  • 2100 - Fehlender erforderlicher Parameter
  • 2101 - Ungültiger Parameterwert
  • 2201 - Ungültige TLD
  • 2202 - Ungültiges Format des Domänennamens
  • 2204 - Kontaktkennung des Domaininhabers nicht angegeben
  • 2207 - Ungültige Kontaktkennung des Domaininhabers
  • 2210 - Ungültiges DNS-Serverformat
  • 2215 - Die AUTH-ID wurde nicht angegeben und ist für diese Domäne erforderlich
  • 2245 - Zustimmung fehlt
  • 2246 - Fehler bei den Zustimmungsdaten
  • 2252 - Domänenanforderungen überschritten
  • 2263 - AUTH-ID ist kürzer als die erforderliche Mindestlänge
  • 2271 - Ungültiges AUTH-ID-Format
  • 3001 - Ungültige Kreditkontowährung
  • 3003 - Ungültige Rechnungsdaten für das Kreditkonto
  • 3207 - Domain ist bereits bei uns registriert
  • 3208 - Übertragung aufgrund des Ablaufdatums fehlgeschlagen
  • 3217 - Es konnte keine Verbindung zur Registry hergestellt werden
  • 3218 - Übertragung nicht möglich
  • 3219 - Bereits ausstehender Transferauftrag für diese Domain
  • 3220 - Die Domain ist bereits in unserem Register registriert
  • 3226 - Übertragung der Domain fehlgeschlagen
  • 3227 - Autorisierungsfehler bei der Domainregistrierung
  • 3258 - Ausfallzeiten der Registry
  • 3266 - Kann nicht übertragen werden, da die Domain abgelaufen ist
  • 3267 - Autoritative DNS-Server konnten nicht aufgelöst werden
  • 4002 - Guthaben wurde nicht vom Guthabenkonto abgezogen
  • 4003 - Abrechnungszeitraum konnte nicht erstellt werden
  • 4206 - Es konnte nicht festgestellt werden, ob die Domäne übertragen werden kann - Verbindungsfehler
  • 4209 - Fehler bei der Bestimmung der Überweisungsart (mit/ohne Erneuerung)
  • 5001 - Interner Anmeldefehler
  • 5002 - Verrechnungspreis konnte nicht berechnet werden
  • 5004 - Ausfallzeiten bei der Rechnungsstellung

Antwortdaten

  • num - Bestellnummer
  • Ablauf - Ablaufdatum der Domäne

Schablonen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-transfer",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "auth_info": "AUTH-ID",
      "dns": {
        "server1":
          {
            "name": "ns1.mydns.tld"
          },
        "server2":
          {
            "name": "ns2.mydns.tld"
          }
        }
      },
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
   }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-transfer",
    "data": {
      "num": "order number",
      "expiration": "YYYY-MM-DD"
    }
  }
}

domain-send-auth-info

Verwenden Sie die Anforderung domain-send-auth-info, um die AUTH-ID einer Domain an die E-Mail des Domaininhabers zu senden.

Parameter

  • name - Domänenname - erforderlich

Rückgabewerte

  • 1000 - AUTH-ID wird an die E-Mail des Domaininhabers gesendet 
  • 2243 - Senden von auth_info nicht erlaubt
  • 3209 - Senden von auth_info fehlgeschlagen
  • 3210 - auth_info konnte nicht gesendet werden - Domain ist nicht verfügbar
  • 3222 - Domain konnte nicht abgerufen werden
  • 3223 - Die Domain gehört nicht zu diesem Kundenkonto
  • 4214 - Senden von auth_info fehlgeschlagen - Verbindungsfehler - später erneut versuchen

Antwortdaten

Die Anfrage liefert keine Daten.

Schablonen

JSON-Anfrage:

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

JSON-Antwort (OK):

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

domain-tld-period-check

Verwenden Sie die Abfrage domain-tld-period-check, um festzustellen, ob für eine TLD ein bestimmter Registrierungszeitraum festgelegt werden kann.

Parameter

  • tld - TLD
  • Zeitraum - Anzahl der Jahre

Rückgabewerte

  • 1000 - Zeitraum kann für diesen Bereich verwendet werden
  • 2203 -Zeitraum kann für diese Domäne nicht verwendet werden

Antwortdaten

Die Anfrage liefert keine Daten.

Schablonen

JSON příkaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-tld-period-check",
    "clTRID": "your ID",
    "data": {
      "tld": "domain tld",
      "period": "number of years"
    }
  }
}

JSON-Antwort (OK):

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

War dies hilfreich?

Vielen Dank für Ihr Feedback!
Allgemeine Selektoren
Nur exakte Treffer
Suche im Titel
Suche im Inhalt
Post Type Selectors
Artikel TOC
Kategorien durchsuchen