Registrar dominio
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) | Set to member to use your member profile instead of the supplied contact details. | member |
| document_type | String | Required for HK domains. Common values: PASSNO (Passport), OTHIDV (Other Individual Document Number), OTHORG (Other Organization Document Number). | PASSNO |
| document_number | String (1-40 bytes) | Document number matching the selected type. Required for HK domains. | E12345678 |
HK domains require both document fields, including when using contact_source=member. Other domains ignore them. For .com.hk, only BR is accepted.
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",
}
