Suche in diesem Bereich
Anleitung zur vollständigen Automatisierung der Laufzeitverlängerung einer Domain (DomainRenew).
Grundlagen der JSON-und XML-API
Alle wichtigen Informationen für die Nutzung der JSON- und XML-API findest du bei den API-Grundlagen, den XML- und JSON-Grundlagen.
Prozess-ÜbersichtAblauf-Diagramm
Auftragstypen, Codes und Routen
Auftragstyp | Code | Route |
---|---|---|
DomainRenew | 0101003 | PUT /domain/ {name} /_renew |
PollInfo | 0905 | GET /poll |
PollConfirm | 0906 | PUT /poll/$id |
DomainInfo | 0105 | GET / domain/$name |
Voraussetzungen
Domain-Daten abrufen (DomainInfo)
Für den DomainRenew-Auftrag wird das Fälligkeitsdatum der Domain benötigt. Es kann mit einem DomainInfo-Auftrag abgerufen werden. Das Fälligkeitsdatum ist im Feld payable
angegeben. Im Beispiel ist es 2020-12-31 12:00:00.
Ablauf
Domain verlängern (Domain Renew)
Mit dem Auftragstyp DomainRenew startest du die Laufzeitverlängerung einer Domain. Das zuvor ermittelte Fälligkeitsdatum ist im Auftrag erforderlich, z. B. um eine versehentliche doppelte Verlängerung zu verhindern.
DomainRenew - Beispiel
Auftragsbenachrichtigung per Polling abrufen (Poll Info und Poll Confirm)
Der Auftragstyp DomainRenew erzeugt automatisch einen Auftrag für die Verlängerung der Domain.
Ist der Auftrag abgearbeitet, wird eine Auftragsbenachrichtigung erzeugt, die Aufschluss darüber gibt, ob die Laufzeitverlängerung erfolgreich war oder nicht. Da du diese über das Polling-Verfahren abrufen kannst, wird sie auch als "Poll Message" bezeichnet.
Du musst die Poll Message mit dem Auftragstyp PollInfo abrufen. Das Abrufen musst du dann mit dem Auftragstyp PollConfirm bestätigen.
Weitere Details zu asynchronen Benachrichtigungen findest du auf der Seite Asynchrone Benachrichtigungen.
PollInfo - Beispiel
PollConfirm - Beispiele
Domain-Daten abrufen (Domain Info)
Nach erfolgreicher Laufzeitverlängerung kannst du das neue Fälligkeitsdatum der Domain (Feld payable
) mit einem DomainInfo-Auftrag ermitteln.
Da die Domain-Laufzeit in diesem Beispiel um ein Jahr verlängert wurde, hat das Feld payable
den neuen Wert 2021-12-31 00:00:00.