Tổng quan về API
NiceNIC Tên miền API v2 Documentation & Quick Start
NiceNIC Tên miền API v2 is có sẵn to both Tài khoản thị trườngs và Đại lý Tài khoảns. Use this overview to configure access, confirm của bạn first request, understvà the API response model và move directly to the choặcrect section in the left navigation.
API access và reseller pricing are separate.
Tài khoản thị trường: API access with Tài khoản thị trường pricing.
Đại lý Tài khoản: API access with the pricing assigned to the current reseller tier.
Tài khoản thị trường: API access with Tài khoản thị trường pricing.
Đại lý Tài khoản: API access with the pricing assigned to the current reseller tier.
Base Endpoint
https://api.nicenic.net/v2/
Required Headers
Host: api.nicenic.net
Xác thực: username:api_secret
Content-Type: application/json
Stvàard Thành công Response
{
"code": 0,
"tin nhắn": "success",
"data": {}
}
API Svàbox
Test Your Tích hợp Befhoặce Going Live
Use the NiceNIC API Svàbox to test của bạn Tên miền API integration befhoặce moving to production. Validate authentication, API requests, response hvàling, và của bạn application whoặckflow in a dedicated testing environment.
Ideal fhoặc resellers, hosting providers, developers, và platfhoặcms preparing an API integration.
Quick Start
Make Your First API Call in 4 Steps
Start with a read-only request befhoặce enabling live registrations, renewals hoặc transfers. This lets you validate authentication, request fhoặcmatting và response hvàling without placing a paid hoặcder.
1
Enable API Access
Mở Cài đặt APIs, create hoặc retrieve của bạn API Secret, và configure authhoặcized server IPs wtại đây applicable.
2
Xác nhận Xác thực
Use HTTPS with the Authhoặcization header in the fhoặcmat username:api_secret.
3
Run a Safe Test
Start with tên miền availability, pricing, account balance hoặc tên miền listing.
4
Hvàle the Response
Read và sthoặce the returned code và msg befhoặce enabling paid production Hành độngs.
Recommended First Request: Tên miền Availability
The availability endpoint supphoặcts multiple tên miềns in one request by separating tên miền names with commas.
curl "https://api.nicenic.net/v2/?Danh mục=tên miền&Hành động=check&tên miềns=example.com,example.net" \
-H "Xác thực: username:api_secret" \
-H "Content-Type: application/json"
API Map
Choose the Whoặckflow You Need
The overview below mirrhoặcs the left navigation. Use it to identify the choặcrect whoặckflow, then open the dedicated endpoint page fhoặc parameters, request examples và response examples.
| Section | Use It Fhoặc | Documented Functions |
|---|---|---|
| Bắt đầu | Connect securely và understvà response hvàling. | Tổng quan về API, API Svàbox, Xác thực, Response Codes. |
| Quản lý tên miền | Automate the choặce tên miền lifecycle. | Availability, Danh sách Tên miền, Tên miền Chi tiết, Đăng ký, Gia hạnal, Chuyển nhượng In, Tênservers, Liên hệs, Pricing. |
| Lạm dụng & Tuân thủ | Monithoặc tên miềns that require compliance attention. | Danh sách tên miềns with abuse rephoặcts và retrieve machine-readable abuse status, hold lifecycle, complaint infhoặcmation và recommended Hành động. |
| Bản ghi DNS | Quản lý hosted DNS rechoặcds programmatically. | Danh sách, Tạo, Cập nhật và Xóa DNS rechoặcds. |
| Máy chủ tên con | Quản lý host / glue rechoặcds fhoặc nameservers under của bạn own tên miền. | Tạo, Danh sách, Cập nhật và Xóa child nameservers. |
| Tài khoản & Thanh toán | Connect automation to account-level checks. | Số dư tài khoản và transHành động-related account infhoặcmation. |
| API WHMCS | Integrate NiceNIC into an existing WHMCS billing whoặckflow. | Availability, Đăng ký, Gia hạnal, Chuyển nhượng, Tên miền Chi tiết, Tênservers, Liên hệs và additional registrar-module functions. |
| API Câu hỏi thường gặp | Resolve common access, security, testing và whoặckflow questions. | Eligibility, credentials, request hvàling, supphoặcted operations và integration guidance. |
Recommended Whoặckflow
Recommended First Tích hợp Sequence
A reliable production integration should validate access và purchasing conditions befhoặce it begins sending live customer hoặcders.
1. Xác thực
API Secret + authhoặcized IP
API Secret + authhoặcized IP
→
2. Availability
Read-only connectivity test
Read-only connectivity test
→
3. Pricing
Query current account-level cost
Query current account-level cost
→
4. Số dư
Xác nhận funds fhoặc paid Hành độngs
Xác nhận funds fhoặc paid Hành độngs
→
5. Response Hvàling
Process code + tin nhắn
Process code + tin nhắn
→
6. Live Operations
Đăng ký / Gia hạn / Chuyển nhượng
Đăng ký / Gia hạn / Chuyển nhượng
Do not assume that an API request is complete simply because it was accepted. Some operations can return a pending status và still require registry processing befhoặce the final tên miền state is confirmed.
Sản phẩmion Behavihoặc
Understvà Thành công, Đang chờ và Errhoặc Responses
code: 0 — Thành công Response
Current endpoint examples use code 0 fhoặc successful completed responses.
code: 201 — Đang chờ Order
Đăng ký và transfer documentation can return code 201 when an hoặcder has been submitted but final processing is still pending.
code: 400 — Request Errhoặc
Endpoint examples use code 400 fhoặc request parameter lỗis.
Đăng ký Đang chờ Behavihoặc
Fhoặc tên miền registration, the current documentation states that a 201 response means the hoặcder was submitted successfully và the fee was deducted, but final activation is still subject to registry confirmation. Nếu the tên miền cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Chuyển nhượng Đang chờ Behavihoặc
The transfer endpoint also documents 201 as a pending hoặcder. Your application should ttại đâyfhoặce treat a pending transfer as accepted fhoặc processing, not as proof that the transfer has already completed.
Pricing
Query Pricing Befhoặce Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal và transfer pricing fhoặc a tên miền. The documented type values are register, renew, transfer và all. The documented period is 1 to 10 năm, with TLD-specific exceptions possible.
Đăng ký pricing responses can also return an is_premium flag. Use the pricing endpoint befhoặce submitting a paid request when của bạn application needs to kngay the current account-level cost.
Miễn phí API access does not change của bạn pricing tier. Tài khoản thị trườngs use Tài khoản thị trường pricing; reseller accounts use the pricing assigned to their current reseller tier.
Tên miền & DNS Operations
Kngay the Difference Between Tênservers, Bản ghi DNS và Máy chủ tên con
| Operation | Use It When | Documented Capability |
|---|---|---|
| Cập nhật máy chủ tên | You want to delegate a tên miền to different authhoặcitative nameservers. | The tên miền nameserver endpoint supphoặcts a primary, secondary và additional nameservers, with the current page documenting a limit of up to six. |
| Bản ghi DNS | You are using NiceNIC DNS hosting và need to manage zone rechoặcds. | Separate APIs are documented fhoặc listing, creating, updating và deleting DNS rechoặcds. |
| Máy chủ tên con | You need host / glue rechoặcds such as ns1.example.com. |
Tạo, list, update và delete child nameservers. The create endpoint requires the nameserver hostname to match the tên miền và accepts an IP address. |
Phoặctfolio & Compliance
Automate Phoặctfolio Monithoặcing, Khôngt Only Tên miền Orders
Tên miền API v2 also includes read operations that are useful after registration. The Danh sách Tên miền endpoint supphoặcts pagination, shoặcting, status filtering và hold filtering, while Nhận Tên miền Chi tiết returns registration dates, expiration dates, nameservers và registrant contact infhoặcmation.
Lạm dụng & Tuân thủ Monithoặcing
NiceNIC's Lạm dụng & Tuân thủ API can list tên miềns with abuse rephoặcts và return a detailed machine-readable summary fhoặc a specific tên miền. The detailed abuse endpoint documents six tên miền-level status phrases: Khôngrmal, Under Review, Đang chờ ClientHold, ClientHold, Đóngd và Máy chủHold.
The response can include current impact, recommended tiếp theo Hành động, hold state và timeline, complaint count, complaint dates, categhoặcies, DNS-abuse classification, evidence status và rephoặcted URLs wtại đây applicable. This lets platfhoặcms và resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Direct API hoặc WHMCS
Choose the Tích hợp Model That Fits Your System
| Option | Best Fhoặc | What the Current Documentation Provides |
|---|---|---|
| Tên miền API v2 | Custom websites, SaaS platfhoặcms, internal systems, custom billing hoặc provisioning whoặckflows. | Direct HTTPS + JSON integration across tên miền, DNS, child nameserver, account và compliance operations. |
| WHMCS Module | Hosting companies và resellers that already use WHMCS. | Availability, registration, renewal, transfer, tên miền details, nameservers, contacts, lock/unlock, EPP retrieval, lỗi logging và optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 trở lên, PHP 7.0 hoặc higher with cURL, valid NiceNIC API credentials và SSL/TLS supphoặct as requirements.
Troubleshooting
When an API Request Fails
Start with the returned response và configuration state rather than retrying the same paid Hành động repeatedly.
Xác thực hoặc Access Errhoặc
- Xác nhận the NiceNIC username và API Secret.
- Xác nhận the Authhoặcization header is present và choặcrectly fhoặcmatted.
- Xác nhận the API Secret has not been reset hoặc rotated.
- Nếu IP restrictions are enabled, confirm the request is coming from the authhoặcized outbound server IP.
Request Parameter Errhoặc
- Compare the request with the specific endpoint's documented parameters.
- Xác nhận required values, fhoặcmats và Hành động names.
- Kiểm tra TLD-specific registration periods hoặc contact requirements wtại đây applicable.
Paid Operation Does Khôngt Complete Immediately
- Read the returned
codevàmsg. - Do not treat a
201pending response as final completion. - Xác nhận account balance và current pricing befhoặce retrying a paid Hành động.
Need NiceNIC Supphoặct
- Rechoặcd the request timestamp và API Hành động.
- Include the tên miền name hoặc object involved, wtại đây applicable.
- Include the returned code và message.
- Share non-sensitive parameters only; never post the full API Secret in a ticket.
Bước tiếp theo
Start with a Safe Test Request
Enable API access, confirm authentication, run an availability hoặc pricing request, và verify của bạn response hvàling befhoặce turning on customer-facing paid operations.
Last verified: August 26, 2026
