This manual is intended to guide users on how to manually or automatically renew free domains that are about to expire through the DNSHE console or API.
I. Core Renewal Rules
-
Renewal window: Opens 180 days before the domain expiration date.
-
Web-based operation: Log in to the admin console and click the “Free Renewal” button that appears next to the domain. After a successful operation, the new expiration date will be displayed.
-
Cost: Completely free.
II. API-Based Automated Renewal Process
If you need to manage multiple domains, using the API is recommended.
Step 1: Obtain API Credentials
On the DNSHE domain page, go to [API Management] and create and save the following two key credentials:
-
X-API-Key -
X-API-Secret
Step 2: Retrieve the Domain ID (subdomain_id)
Before performing a renewal, you must first obtain the internal ID of the target domain.
Query command:
Example response parsing:
The API will return a list of all domains. Locate the id field corresponding to the domain you want to renew.
Step 3: Submit the Renewal Request
Replace the subdomain_id parameter in the command below with the id you obtained.
Renewal command:
III. Renewal Result Verification
After executing the renewal command, check the returned JSON data.
Successful renewal example:
Verification checklist:
-
successistrue -
new_expires_athas been updated to one year later
Status Field Reference
| Field | Description |
|---|---|
previous_expires_at |
Expiration date before renewal |
new_expires_at |
Expiration date after renewal |
charged_amount |
Renewal fee (0 means free) |
remaining_days |
Number of days remaining until the new expiration date |
