Search in this section
Instructions for the complete automation of the prologation of the domain registration period (DomainRenew).
Basics of the JSON and XML API
All important information for the use of the JSON and XML API you can find in the General API Basics and the XML API Basics and JSON API Basics.
Process Overview
Flow Chart
Task Names, Codes and Routes
DomainRenew | 0101003 | PUT /domain/ {name} /renew |
PollInfo | 0905 | GET /poll |
PollConfirm | 0906 | PUT /poll/$id |
DomainInfo | 0105 | GET / domain/$name |
Requirements
Inquire Domain Data
For the DomainRenew request, the due date of the domain is required. It can be retrieved with a DomainInfo request. The due date is indicated in the payable
field.
In the example it is 2020-12-31 12:00:00.
Process
Renew Domain
The DomainRenew order type is used to start the domain prologation of the domain registration period. The previously determined due date is required in the order, e.g. to prevent an accidental double prolongation.
DomainRenew - Example
Checking and confirming Notifications
The order type DomainCancelationCreate creates a cancelation request. This triggers the creation of a second cancelation request, which is processed asynchronously at the time defined in the cancelation.
Once this second requst has been processed, a request notification is sent, indicating whether the deletion was successful or not.
You must call the notification with the PollInfo task. You must confirm the retrieval with the PollConfirm task.
For more details on asynchronous notifications, see :
- JSON API: Asynchronous Notifications
- XML API: Interface Documentation
PollInfo - Examples
PollConfirm - Examples
Inquire Domain Data
After a successful renew, you can determine the new due date of the domain (payable field) with a DomainInfo request. Since the domain registration period in this example was extended by one year, the payable field has the new value 2021-12-31 00:00:00.