Suche in diesem Bereich
Anleitung zur vollständigen Automatisierung der Registrierung einer Domain, am Beispiel der Domain example.com verwendet. .com ist eine generische Top-Level-Domain. Aufgrund fehlender Beschränkungen, eignet sich diese TLD bestens für die erste Implementierung.
Voraussetzungen
Domainkontakte
Für die Bestellung einer .com Domain wird ein Domaininhaber (OwnerC), ein administrativer Kontakt (AdminC) und ein technischer Kontakt (TechC) benötigt. Sie können bereits vorhandene Kontakte verwenden oder neue Kontakte anlegen.
Welche Daten ein Kontakt für die Registrierung einer Domain enthalten muß, hängt von der TLD ab. Jede Registry hat dabei ihre eigenen Richtlinien. Für einige TLDs werden sogenannte Kontakterweiterungen (Extensions) benötigt. Detaillierte Informationen zu allen TLDs, die wir anbieten, finden Sie in der TLD Wissensdatenbank
Zur Prozessbeschreibung Domainkontakt anlegen.
Die Domain registrieren
Auftrag starten
Mit dem Auftragstyp DomainCreate starten Sie die Registrierung der Domain. Dabei müssen Sie mindestens diese Werte angeben:
- Kontakte: Die Kontakt-ID der geforderten Kontakte. Bei .com-Domains wird ein Domaininhaber, ein administrativer sowie ein technischer Kontakt benötigt.
- Domain: Der Name der Domain
- Nameserver: Die gewünschten Nameserver an. Die Anzahl der benötigten Nameserverabhängig von der TLD.
Welche weiteren Daten für eine Domain benötigt werden hängt von der TLD ab. Jede Registry hat dabei ihre eigenen Richtlinien. Weitere Informationen dazu finden Sie in der TLD Wissensdatenbank.
Beispiele für Aufträge und Antworten (Requests and Responses)
DomainCreate Request
DomainCreate Response
DomainCreate Request
Domain Create Response
Auftrags-Benachrichtigung per Polling abrufen
Der Auftragstyp DomainCreate wird asynchron verarbeitet.
Er erzeugt automatisch einen Auftrag für die Registrierung der Domain. Ist der Auftrag abgearbeitet, wird eine Auftrags-Benachrichtigung erzeugt, die Aufschluss darüber gibt, ob die Registrierung erfolgreich war oder nicht. Da Sie diese über das Polling-Verfahren abrufen können, wird Sie auch als PollMessage bezeichnet.
Sie müssen die PollMessage mit dem Auftragstyp PollmessageInfo abrufen. Das Abrufen müssen Sie mit dem Auftragstyp PollmessageConfirm bestätigen.
Weitere Details zu den Benachrichtigungen finden Sie auf der Seite Asynchrone Benachrichtigungen.
Beispiele für Aufträge und Antworten (Requests and Responses)
Domaindaten abrufen
Nach erfolgreicher Registrierung können Sie die im System hinterlegten Registrierungsdaten mit dem Auftragstyp DomainInfo abfragen. Die können so feststellen, ob die Domain mit den gewünschten Daten registriert wurde. Use Cases mit Marius/Kutti besprechen; wann ist der task sinnvoll
Zur Prozessbeschreibung Domaindaten ermitteln
Auftragstypen, Auftragstypen-Codes und Routen
Auftragstyp | Code | Route |
---|---|---|
ContactCreate | 0301 | POST /contact |
DomainCreate | 0101 | POST /domain |
PollMessageInfo | 0905 | GET /poll |
PollMessageConfirm | 0906 | PUT /poll/$id |
DomainInfo | 0105 | GET / domain/$name |
Ablauf-Diagramm