Register Domain
Domain name registration is the process of reserving a unique name on the Internet for a specific period of time, usually one year or more
Content-Type
application/json
category
domain
action
register
Request parameters
| Parameter Name | Type | Describe | Example |
|---|---|---|---|
| domain | String (3-60) | Domain name | example.com |
| year | Integer (4) | The registration period is from 1 to 10 years, with some exceptions for certain domains. | 1 |
| dns1 | Server | Primary nameserver | ns3.my-ndns.com |
| dns2 | Server | Secondary nameserver | ns4.my-ndns.com |
| organization | String (1-255) | Organization / Company name | XXX Ltd. |
| name | String (1-16) | Registrant name | Xiao Ming |
| country | String (1-255) | Country Code, such as CN | CN |
| state | String (1-255) | Province / State | BeiJing |
| city | String (1-255) | City acronym | BJ |
| address | String (1-255) | Mailing address | BeiJing |
| postcode | Integer (4-10) | Post code / Zip code | 100000 |
| phone | "." to separate numbers (30) | +Country code.district code and phone number | +86.13800000000 |
| fax | "." to separate numbers (30) | +Country code.district code and fax numbe | +86.13800000000 |
| Email address | Email address | [email protected] | |
| contact_source | String (1-255) | Contact source, if set to member, contact information will be the same as member information, and other contact information will be ignored | member |
Response parameters
| Parameter Name | Type | Describe |
|---|---|---|
| domain | String | Domain name |
| created_date | Date | Domain registration time |
| expired_date | Date | Domain expiration date |
Request Example
{
curl https://api.nicenic.net/v2/?category=domain&action=register&domain={domain}&year={year}&dns1={dns1}&dns2={dns2}&organization={organization}&name={name}&country={country}&state={state}&city={city}&address={address}&postcode={postcode}&phone={phone}&fax={fax}&email={email}&contact_source={contact_source}
-H "Authorization: username:api_secret"
-H "Content-Type: application/json"
}
Return result
0 OK
Successful response
{
"code": 0,
"msg" : "success",
"data" : {
"domain":"example.com",
"created_date":"2025-01-21",
"expired_date":"2026-01-21"
}
}
201 Pending
Pending order
{
"code": 201,
"msg" : "Pending order, please wait for the order to be processed!"
}
}
Note: code "201" means the registration order was submitted successfully and the fee was deducted. Final domain activation is still subject to registry confirmation. If the domain cannot be activated, the registration fee will be refunded to your account balance within 24 hours.
400 Bad Request
{
"code": 400,
"msg" : "Request parameter error",
}
