API documentation
Đăng ký tên miền
Đăng ký tên miền là quá trình giữ chỗ một tên duy nhất trên Internet trong một khoảng thời gian nhất định, thường là một năm hoặc lâu hơn
Content-Type
application-json
Danh mục
domain
Hành động
register
Tham số yêu cầu
| Tên tham số | Kiểu | Mô tả | Ví dụ |
|---|---|---|---|
| domain | Chuỗi (3-60) | Tên domain | example.com |
| year | Số nguyên (4) | Thời hạn đăng ký từ 1 đến 10 năm, với một số ngoại lệ đối với một số domain. | 1 |
| dns1 | Máy chủ | Máy chủ tên chính | ns3.my-ndns.com |
| dns2 | Máy chủ | Máy chủ tên phụ | ns4.my-ndns.com |
| organization | Chuỗi (1-255) | Tên tổ chức / công ty | XXX Ltd. |
| name | Chuỗi (1-16) | Tên người đăng ký | Xiao Ming |
| country | Chuỗi (1-255) | Mã quốc gia, chẳng hạn CN | CN |
| state | Chuỗi (1-255) | Tỉnh / bang | BeiJing |
| city | Chuỗi (1-255) | Chữ viết tắt thành phố | BJ |
| address | Chuỗi (1-255) | Địa chỉ thư tín | BeiJing |
| postcode | Số nguyên (4-10) | Mã bưu chính / Zip code | 100000 |
| phone | "." để phân tách các số (30) | +Mã quốc gia.mã vùng và số điện thoại | +86.13800000000 |
| fax | "." để phân tách các số (30) | +Mã quốc gia.mã vùng và số fax | +86.13800000000 |
| Địa chỉ email | Địa chỉ email | [email protected] | |
| contact_source | Chuỗi (1-255) | Liên hệ nguồn, nếu được đặt thành thành viên, thông tin liên hệ sẽ giống với thông tin thành viên, và các thông tin liên hệ khác sẽ bị bỏ qua. | member |
Tham số phản hồi
| Tên tham số | Kiểu | Mô tả |
|---|---|---|
| domain | Chuỗi | Tên domain |
| created_date | Ngày | Thời gian đăng ký domain |
| expired_date | Ngày | Ngày hết hạn của domain |
Ví dụ yêu cầu
{
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"
}
Kết quả trả về
0 OK
Phản hồi thành công
{
"code": 0,
"msg" : "success",
"data" : {
"domain":"skwncks.com",
"created_date":"2025-01-21",
"expired_date":"2026-01-21"
}
}
201 Đang chờ
Đang chờ hoặcder
{
"code": 201,
"msg" : "Pending order, please wait for the order to be processed!"
}
}
Lưu ý:mã "201" có nghĩa là đơn đăng ký đã được gửi thành công và phí đã được trừ. Việc kích hoạt tên miền cuối cùng vẫn phụ thuộc vào xác nhận của nhà đăng ký. Nếu tên miền không thể kích hoạt, phí đăng ký sẽ được hoàn trả vào số dư tài khoản đại lý của bạn trong vòng 24 giờ.
400 Yêu cầu không hợp lệ
{
"code": 400,
"msg" : "Request parameter error",
}
