API documentation
Domain registration
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] |
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 http://api.www.unionroom.cn/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}
-H "Authorization: username:api_secret"
-H "Content-Type: application/json"
}
Return result
0 OK
Successful response
{
"code": 0,
"msg" : "success",
"data" : {
"domain":"skwncks.com",
"created_date":"2025-01-21",
"expired_date":"2026-01-21"
}
}
400 Bad Request
{
"code": 400,
"msg" : "Request parameter error",
}
