WAPI – Domainkontakte

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.

Diese Anleitung behandelt WAPI-Anfragen für die Arbeit mit Domainkontakten. Anleitungen zu Domains finden Sie unter WAPI – Domains.

In diesem Artikel finden Sie Informationen zur Verwaltung von Domain-Kontakten mit den folgenden unterstützten TLDs:

und auch bei den folgenden Befehlen:

Domain-Kontakte nach einzelnen Registries

Jede Domain-Registry verwaltet Kontakte anders, es gelten unterschiedliche Regeln für Kontaktkennungen, Pflichtangaben in den Details und so weiter.

Üblicherweise können Sie nur den Firmennamen sowie Vor- und Nachnamen festlegen, d. h. company, fname und lname Parameter beim Anlegen eines Kontakts, da die Registries eine Änderung dieser Angaben einer Änderung des Inhabers gleichsetzen. Genauere Informationen finden Sie weiter unten.

CZ-Domains

Beim Anlegen eines Kontakts für eine CZ-Domain können Sie einen Namen angeben. Verwenden Sie das contact-check um zu prüfen, ob der gewählte Name verfügbar ist (nicht verwendet, nicht blockiert, ..).

Der Kontaktname darf nur Großbuchstaben des englischen Alphabets, Zahlen und einen Bindestrich enthalten. Wenn Sie beim Anlegen eines Kontakts keinen Namen angeben, erzeugt das System automatisch einen.

Im Kontaktdetail können Sie festlegen:

  • cname – Kontaktname (nur beim Anlegen eines neuen); lassen Sie diesen Parameter weg oder leer, um einen pseudozufälligen Namen zu generieren)
  • company
  • fname – Name – erforderlich
  • lname – Nachname – erforderlich
  • email – erforderlich
  • Telefon – Telefonnummer +XXX XXXXXXXXX
  • fax – Faxnummer +XXX XXXXXXXXX
  • dic – USt-IdNr.
  • addr_street – Straße und Hausnummer – erforderlich
  • addr_city – Stadt der Adresse – erforderlich
  • addr_zip – PLZ – erforderlich
  • addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben) – erforderlich
  • addr_state – Bundesland oder Region
  • ident_type – Typ des Ausweisdokuments (ico (Firmen-ID), op (Personalausweis), birthday (Geburtsdatum im Format DD.MM.YYYY), passport, mpsv (MPSV-ID))
  • ident – Nummer des Ausweisdokuments (abhängig von ident_type)
  • notify_email – Benachrichtigungs-E-Mail-Adresse
  • disclose_phone – Telefon verbergen
  • disclose_fax – Fax verbergen
  • disclose_email – E-Mail verbergen
  • disclose_ident – Nummer des Ausweisdokuments verbergen
  • disclose_notify_email – Benachrichtigungs-E-Mail verbergen

Bei Kontakten von CZ-Domains ist es möglich, einige Elemente in den Kontaktdetails zu verbergen. Verwenden Sie den disclose_* Einträge im Kontaktdetail mit einem Flag 0/1 (1 = verborgen, 0 = öffentlich), um festzulegen, ob diese Information verborgen werden soll. Ist diese Information als verborgen gekennzeichnet, kann sie ohne Autorisierung nicht eingesehen werden.

Ab Mitte Januar 2018 können Sie ein Lieferadresse für Kontakte von CZ-Domains. Geben Sie beim Anlegen/Bearbeiten eines Kontakts die folgenden Angaben ein:

  • del_addr=1 – aktive Lieferadresse (erforderlich)
  • del_addr_street1 – Straße (erforderlich)
  • del_addr_street2 – Straße (optional)
  • del_addr_street3 – Straße (optional)
  • del_addr_city – Stadt (erforderlich)
  • del_addr_state – Bundesland oder Region
  • del_addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben) (erforderlich)

Um die Lieferadresse für einen Kontakt zu deaktivieren, geben Sie ein del_addr=0 beim Anlegen/Bearbeiten eines Kontakts.

EU-Domains

Beim Anlegen eines Kontakts in der EURid-Registry können Sie dessen Name. Das System weist ihn immer automatisch zu.

Im Kontaktdetail können Sie festlegen:

  • company
  • fname – Name – erforderlich
  • lname – Nachname – erforderlich
  • email – erforderlich
  • Telefon – Telefonnummer +XXX XXXXXXXXX
  • fax – Faxnummer +XXX XXXXXXXXX
  • dic – USt-IdNr.
  • addr_street – Straße und Hausnummer – erforderlich
  • addr_city – Stadt der Adresse – erforderlich
  • addr_zip – PLZ – erforderlich
  • addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben) – erforderlich
  • addr_state – Bundesland oder Region

SK-Domains

Beim Anlegen eines Kontakts für eine SK-Domain können Sie einen Namen angeben. Verwenden Sie das contact-check um zu prüfen, ob der gewählte Name verfügbar ist (nicht verwendet, nicht blockiert, ..).

Der Kontaktname darf nur Großbuchstaben des englischen Alphabets, Zahlen, Bindestriche und Punkte enthalten. Die Mindestlänge des Kontaktnamens beträgt 5 Zeichen, die maximale Länge 16 Zeichen. Wenn Sie beim Anlegen eines Kontakts keinen Namen angeben, erzeugt das System ihn automatisch. Das Format des automatisch erzeugten Kontaktnamens ist WEDOS-XXX-YYYY (wobei XXX eine Kombination aus Buchstaben und Zahlen ist und YYYY nur aus Ziffern besteht).

Im Kontaktdetail können Sie festlegen:

  • cname – Kontaktname (nur beim Anlegen eines neuen); lassen Sie diesen Parameter weg oder leer, um einen pseudozufälligen Namen zu generieren)
  • company
  • fname – Name – erforderlich
  • lname – Nachname – erforderlich
  • email – erforderlich
  • Telefon – Telefonnummer +XXX XXXXXXXXX
  • fax – Faxnummer +XXX XXXXXXXXX
  • dic – USt-IdNr.
  • addr_street – Straße und Hausnummer – erforderlich
  • addr_city – Stadt der Adresse – erforderlich
  • addr_zip – PLZ – erforderlich
  • addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben) – erforderlich
  • addr_state – Bundesland oder Region
  • ident_type – Subjekttyp, kann nur einmal festgelegt werden (PERS = natürliche Person, CORP = Firma)
  • ident – Identifikationswert (PERS = Geburtsdatum im Format RRRR-MM-DD, CORP = Firmennummer)
  • disclose_name – Namen verbergen
  • disclose_org – Firmennamen verbergen
  • disclose_addr – Adresse verbergen
  • disclose_phone – Telefon verbergen
  • disclose_fax – Fax verbergen
  • disclose_email – E-Mail-Adresse verbergen

PL-Domains

Beim Anlegen eines PL-Kontakts können Sie dessen Name. Das System weist ihn immer automatisch zu.

Im Kontaktdetail können Sie festlegen:

  • company
  • fname – Name, kann bei legal_type = individual nicht geändert werden – erforderlich
  • lname – Nachname, kann bei legal_type = individual nicht geändert werden – erforderlich
  • email – erforderlich
  • Telefon – Telefonnummer +XXX XXXXXXXXX
  • fax – Faxnummer +XXX XXXXXXXXX
  • dic – USt-IdNr.
  • addr_street – Straße und Hausnummer – erforderlich
  • addr_city – Stadt der Adresse – erforderlich
  • addr_zip – PLZ – erforderlich
  • addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben) – erforderlich
  • addr_state – Bundesland oder Region
  • legal_type – Rechtsform (company, individual), kann nicht geändert werden – erforderlich

gTLD- und nTLD-Domains

Beim Anlegen eines Kontakts für gTLD- und nTLD-Domains können Sie dessen Namen nicht angeben, das System erstellt ihn automatisch.

Im Kontaktdetail können Sie festlegen:

  • company
  • fname – Name – erforderlich
  • lname – Nachname – erforderlich
  • email – erforderlich
  • Telefon – Telefonnummer +XXX XXXXXXXXX
  • fax – Faxnummer +XXX XXXXXXXXX
  • dic – USt-IdNr.
  • addr_street – Straße und Hausnummer – erforderlich
  • addr_city – Stadt der Adresse – erforderlich
  • addr_zip – PLZ – erforderlich
  • addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben) – erforderlich
  • addr_state – Bundesland oder Region

contact-check

Verwenden Sie contact-check Anfrage zur Prüfung der Verfügbarkeit eines Kontaktnamens.

Parameter

  • tld – TLD, für die der Kontakt angelegt wird (z. B. eu)
  • cname – Kontaktname

Rückgabewerte

  • 1000 – Kontakt ist frei und kann verwendet werden
  • 2201 – ungültige TLD
  • 2216 – ungültiges Kontaktformat
  • 2218 – Name wird automatisch generiert (bei manchen TLD kann kein Kontaktname angegeben werden)
  • 3231 – Kontakt existiert bereits
  • 3233 – Kontakt kann nicht verwendet werden
  • 3234 – Kontakt kann nicht verwendet werden – in Quarantäne
  • 3235 – Kontakt kann nicht verwendet werden – reserviert
  • 3236 – Kontakt kann nicht verwendet werden – blockiert
  • 4211 – Überprüfung fehlgeschlagen – Kommunikationsfehler, wiederholen Sie den Befehl später

Antwortdaten

Die Anfrage liefert keine Daten zurück.

Vorlagen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-check",
    "clTRID": "your ID",
    "data": {
      "tld": "tld",
      "cname": "contact id"
    }
  }
}

JSON-Antwort (OK):

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

contact-info

Der contact-info Befehl gibt detaillierte Informationen zu einem Kontakt zurück.

CZ-Domains verwenden ein System von AUTH-IDs, mit denen verborgene Elemente eines Kontakts aufgedeckt werden. Jeder kann die contact-info für jeden bestehenden Kontakt, die verborgenen Informationen erscheinen jedoch nur, wenn eine gültige AUTH-ID übergeben wird. Das System zeichnet den Ersteller des Kontakts auf beziehungsweise denjenigen, der eine gültige AUTH-ID eingegeben hat, und stellt ihm die Informationen zur Verfügung, ohne dass die AUTH-ID wiederholt übergeben werden muss.

Parameter

  • tld – TLD – erforderlich
  • cname – Kontaktname – erforderlich
  • auth_info – AUTH-ID des Kontakts – optional (sofern die Domain dies unterstützt, gibt die Eingabe der AUTH-ID die verborgenen Daten des Kontakts frei)
  • reg_key – ID der Registry – optional

Rückgabewerte

  • 1000 – Kontaktinformationen erfolgreich empfangen
  • 2201 – ungültige TLD
  • 2216 – ungültige Kontaktsyntax
  • 3215 – Senden der Auth-Info des Kontakts fehlgeschlagen
  • 3228 – nicht unterstützter Wert
  • 3229 – Fehler beim Laden des Kontakts
  • 3236 – Kontakt blockiert
  • 4212 – Verbindungsfehler
  • 5001 – nicht angemeldet

Antwortdaten

Bei Erfolg (Code 1000) gibt der Befehl Informationen über den Kontakt im Knoten contact zurück.

Vorlagen

JSON-Anfrage (CZ.NIC-Kontakt):

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "cname": "contact-id",
      "auth_info": "auth-info-string",
      "reg_key": "cznic",
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "contact-info",
    "data": {
      "contact": {
        "contact_id": "contact id",
        "status": "status",
        "name": "name and surname",
        "company": "company",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_state": "state or region",
        "addr_country": "country iso code",
        "phone": "full phone number",
        "email": "email",
        "fax": "full fax number",
        "reg_owner": "",
        "reg_creator": "",
        "reg_update": "",
        "created_date": "YYYY-MM-DD hh:mm:ss",
        "updated_date": "YYYY-MM-DD hh:mm:ss",
        "transfer_date": "YYYY-MM-DD hh:mm:ss",
        "fname": "name",
        "lname": "surname",
        "email2": "",
        "ic": "company id",
        "dic": "vat id",
        "taxpayer": "",
        "disclose": "",
        "other": {
          "notify_email": "",
          "ident_type": "",
          "ident": ""
        }
      }
    }
  }
}

JSON-Antwort (Kontakt nicht gefunden):

{
  "response":
  {
    "code":3215,
    "result":"Contact send auth info failed",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command":"contact-info"
  }
}

contact-create

Verwenden Sie contact-create Anfrage zum Anlegen eines neuen Kontakts, den Sie für Ihre bei der entsprechenden Registry registrierten Domains verwenden können. Jeder Kontakt wird durch seinen Namen identifiziert, der stets eindeutig ist. Weitere Informationen zur Arbeit mit Kontakten bei den einzelnen Registries finden Sie im Kapitel Domain-Kontakte nach einzelnen Registries.

Parameter

  • tld – TLD der Domain
  • contact – Array von Kontaktelementen:
    • cname – Kontaktname (leer = automatisch generieren)
    • fname – Name
    • lname – Nachname
    • company – Firma
    • addr_street – Straße und Hausnummer
    • addr_city – Stadt
    • addr_zip – PLZ
    • addr_state – Bundesland oder Region
    • addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben)
    • Telefon
    • fax
    • email
    • weitere Angaben je nach Registry

Rückgabewerte

  • 1000 = Kontakt wurde erfolgreich angelegt
  • 2201 = ungültige TLD
  • 2216 = ungültiger Kontaktname
  • 2218 = Der Kontaktname wird automatisch erzeugt
  • 2219 = Position Firma nicht ausgefüllt
  • 2220 = Bezeichnung der Position ist nicht ausgefüllt
  • 2221 = Nachname nicht ausgefüllt
  • 2222 = E-Mail nicht ausgefüllt
  • 2223 = E-Mail im falschen Format
  • 2224 = email2 nicht ausgefüllt
  • 2225 = email2 im falschen Format
  • 2226 = Telefon nicht ausgefüllt
  • 2227 = Telefon im falschen Format
  • 2228 = Fax nicht ausgefüllt
  • 2229 = Fax im falschen Format
  • 2230 = Firmennummer nicht ausgefüllt
  • 2231 = Firmennummer im falschen Format
  • 2232 = USt-IdNr. nicht ausgefüllt
  • 2233 = USt-IdNr. im falschen Format
  • 2234 = Straße nicht ausgefüllt
  • 2235 = Stadt nicht ausgefüllt
  • 2236 = PLZ nicht ausgefüllt
  • 2237 = Land nicht ausgefüllt
  • 2238 = Land im falschen Format
  • 2239 = Bundesland nicht ausgefüllt
  • 2240 = sonstige Daten nicht ausgefüllt
  • 2241 = sonstige Daten im falschen Format
  • 3228 = Die Domain arbeitet nicht mit Kontakten
  • 3230 = Anlegen eines Kontakts fehlgeschlagen
  • 3231 = Kontaktname wird bereits verwendet
  • 3232 = Kontakt kann nicht verwendet werden – Grund unbekannt
  • 3233 = Kontakt kann nicht verwendet werden
  • 3234 = Kontakt kann nicht verwendet werden – in Quarantäne
  • 3235 = Kontakt kann nicht verwendet werden – reserviert
  • 3236 = Kontakt kann nicht verwendet werden – blockiert
  • 3237 = Kontakt ist bei uns bereits registriert
  • 4211 = Prüfung des Kontakts fehlgeschlagen – Kommunikationsfehler
  • 4213 = Anlegen eines Kontakts fehlgeschlagen – Kommunikationsfehler

Antwortdaten

Der Kontakt liefert folgende Daten zurück:

  • cname – Name des angelegten Kontakts

Vorlagen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-create",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "contact": {
        "fname": "name",
        "lname": "surname",
        "email": "email",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_country": "country ISO code",
        "phone": "full phone number",
        "notify_email": "notification email"
      }
    }
  }
}

JSON-Antwort (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "contact-create",
    "data": {
      "cname": "contact id"
    }
  }
}

contact-update

Verwenden Sie contact-update Anfrage zum Bearbeiten von Kontakteinträgen.

Geben Sie immer alle Parameter für den Kontakt an, nicht nur die, die du aktualisieren möchtest.

Weitere Informationen zur Arbeit mit Kontakten bei den einzelnen Registries finden Sie im Kapitel Domain-Kontakte nach einzelnen Registries.

Autorisieren Sie alle Änderungen durch Eingabe der AUTH-ID (auth_info) if you do not have authorization set directly for your client account (this occurs after the first successful use of the AUTH-ID or when the contact is created through our system).

Parameter

  • tld – TLD
  • cname – Kontaktname
  • auth_info – AUTH-ID
  • contact – Kontaktelemente
    • fname – Name
    • lname – Nachname
    • company
    • addr_street – Straße und Nummer
    • addr_city – Stadt
    • addr_zip – PLZ
    • addr_state – Bundesland oder Region
    • addr_country – Land (zweistelliger ISO-Code, Kleinbuchstaben)
    • Telefon
    • fax
    • email
    • weitere Angaben je nach Registry

Rückgabewerte

  • 1000 = OK
  • 2201 = ungültige TLD
  • 2207 = ungültige Syntax im Kontaktnamen
  • 2216 = ungültiger Kontaktname
  • 2219 = Position Firma nicht ausgefüllt
  • 2220 = Position Name nicht ausgefüllt
  • 2221 = Position Nachname nicht ausgefüllt
  • 2222 = Position E-Mail nicht ausgefüllt
  • 2223 = falsches Format der Position E-Mail
  • 2224 = Position email2 nicht ausgefüllt
  • 2225 = falsches Format der Position email2
  • 2226 = Position Telefon nicht ausgefüllt
  • 2227 = falsches Format der Position Telefon
  • 2228 = Position Fax nicht ausgefüllt
  • 2229 = falsches Format der Position Fax
  • 2230 = Position Firmennummer nicht ausgefüllt
  • 2231 = falsches Format der Position Firmennummer
  • 2232 = Position USt-IdNr. nicht ausgefüllt
  • 2233 = falsches Format der Position USt-IdNr.
  • 2234 = Position Straße nicht ausgefüllt
  • 2235 = Position Stadt nicht ausgefüllt
  • 2236 = Position PLZ nicht ausgefüllt
  • 2237 = Position Land nicht ausgefüllt
  • 2238 = falsches Format der Position Land
  • 2239 = Position Bundesland nicht ausgefüllt
  • 2240 = Position sonstige Daten nicht ausgefüllt
  • 2241 = falsches Format der Position in den sonstigen Daten
  • 3211 = Fehler – Kontakt konnte nicht abgerufen werden
  • 3238 = Autorisierungsfehler
  • 3239 = Vorgang fehlgeschlagen
  • 4202 = Kontakt nicht verfügbar – Verbindungsfehler, bitte später erneut versuchen
  • 4215 = Ausführung fehlgeschlagen – Verbindungsfehler, bitte später erneut versuchen

Antwortdaten

Die Anfrage liefert keine Daten zurück.

Vorlagen

JSON-Befehl:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-update",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "contact": {
        "fname": "name",
        "lname": "surname",
        "email": "email",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_country": "country ISO code",
        "phone": "full phone number",
        "notify_email": "email"
      }
    }
  }
}

JSON-Antwort (OK):

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

contact-transfer

Verwenden Sie contact-transfer Anfrage zum Transfer eines Kontakts von einem anderen Registrar zu WEDOS.

Nur Kontakte von CZ-Domains unterstützen den Transfer.

Parameter

  • tld – TLD
  • cname – Kontaktname
  • auth_info – AUTH-ID

Rückgabewerte

  • 1000 = OK
  • 2201 = ungültige TLD
  • 2215 = Parameter auth_info fehlt
  • 2216 = ungültige Kontaktkennung
  • 2244 = Diese Domain unterstützt keinen Kontakttransfer
  • 3229 = Kontakt ist nicht verfügbar
  • 3237 = Kontakt ist bei uns bereits registriert
  • 3240 = Autorisierungsfehler
  • 3241 = Transfer fehlgeschlagen
  • 4216 = fehlgeschlagen – Verbindungsfehler

Antwortdaten

Die Anfrage liefert keine Daten zurück.

Vorlagen

JSON-Anfrage:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-transfer",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "cname": "contact id",
      "auth_info": "auth-id"
    }
  }
}

JSON-Antwort (OK):

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

contact-send-auth-info

Verwenden Sie contact-send-auth-info Anfrage zum Senden einer E-Mail mit der AUTH-ID des Kontakts.

Parameter

  • tld – TLD
  • cname – Kontaktname

Rückgabewerte

  • 1000 = OK
  • 2201 = ungültige TLD
  • 2216 = ungültiger Kontaktname
  • 2243 = das Senden von auth_info ist nicht erlaubt
  • 3213 = Kontakt ist nicht verfügbar
  • 3215 = Senden der auth-id fehlgeschlagen
  • 3228 = Kontakt wird für diese Domain nicht unterstützt
  • 4217 = Senden fehlgeschlagen – Kommunikationsfehler

Antwortdaten

Die Anfrage liefert keine Daten zurück.

Vorlagen

JSON-Anfrage:

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

JSON-Antwort (OK):

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

War das hilfreich?

Danke für Ihr Feedback!
Generische Selektoren
Nur exakte Übereinstimmungen
In Titeln suchen
In Inhalten suchen
Post-Type-Selektoren
Inhaltsverzeichnis
Kategorien durchsuchen