API İcmalı
NiceNIC Domen API v2 Documentation & Quick Start
NiceNIC Domen API v2 is mövcuddur to both Bazar Hesabıs və Distribyutor Hesabs. Use this overview to configure access, confirm sizin first request, understvə the API response model və move directly to the cvə yarect section in the left navigation.
API access və reseller pricing are separate.
Bazar Hesabı: API access with Bazar Hesabı pricing.
Distribyutor Hesab: API access with the pricing assigned to the current reseller tier.
Bazar Hesabı: API access with Bazar Hesabı pricing.
Distribyutor Hesab: API access with the pricing assigned to the current reseller tier.
Base Endpoint
https://api.nicenic.net/v2/
Required Başlıqs
Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json
Stvəard Uğur Response
{
"code": 0,
"mesaj": "success",
"data": {}
}
API Svəbox
Test Your İnteqrasiya Befvə yae Going Live
Use the NiceNIC API Svəbox to test sizin Domen API integration befvə yae moving to production. Validate authentication, API requests, response hvəling, və sizin application wvə yakflow in a dedicated testing environment.
Ideal fvə ya resellers, hosting providers, developers, və platfvə yams preparing an API integration.
Quick Start
Make Your First API Call in 4 Steps
Start with a read-only request befvə yae enabling live registrations, renewals və ya transfers. This lets you validate authentication, request fvə yamatting və response hvəling without placing a paid və yader.
1
Enable API Access
Açıq API parametrləris, create və ya retrieve sizin API Secret, və configure authvə yaized server IPs wburada applicable.
2
Təsdiq et Doğrulama
Use HTTPS with the Authvə yaization header in the fvə yamat username:api_secret.
3
Run a Safe Test
Start with domen availability, pricing, account balance və ya domen listing.
4
Hvəle the Response
Read və stvə yae the returned code və msg befvə yae enabling paid production əməls.
Recommended First Request: Domen Availability
The availability endpoint suppvə yats multiple domens in one request by separating domen names with commas.
curl "https://api.nicenic.net/v2/?kateqoriya=domen&əməl=check&domens=example.com,example.net" \
-H "Authorization: username:api_secret" \
-H "Content-Type: application/json"
API Map
Choose the Wvə yakflow You Need
The overview below mirrvə yas the left navigation. Use it to identify the cvə yarect wvə yakflow, then open the dedicated endpoint page fvə ya parameters, request examples və response examples.
| Section | Use It Fvə ya | Documented Functions |
|---|---|---|
| Başlamaq | Connect securely və understvə response hvəling. | API İcmalı, API Svəbox, Doğrulama, Response Codes. |
| Domen İdarəçiliyi | Automate the cvə yae domen lifecycle. | Availability, Siyahı Domenlər, Domen Ətraflı, Qeydiyyat, Yeniləal, Köçürmək In, Adservers, Əlaqəs, Pricing. |
| Zorlama və Uyğunluq | Monitvə ya domens that require compliance attention. | Siyahı domens with abuse repvə yats və retrieve machine-readable abuse status, hold lifecycle, complaint infvə yamation və recommended əməl. |
| DNS qeydləri | İdarə et hosted DNS recvə yads programmatically. | Siyahı, Yarat, Yenilə və Sil DNS recvə yads. |
| Uşaq Ad Serverləri | İdarə et host / glue recvə yads fvə ya nameservers under sizin own domen. | Yarat, Siyahı, Yenilə və Sil child nameservers. |
| Hesab və Ödənişlər | Connect automation to account-level checks. | Hesab Balansı və transəməl-related account infvə yamation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wvə yakflow. | Availability, Qeydiyyat, Yeniləal, Köçürmək, Domen Ətraflı, Adservers, Əlaqəs və additional registrar-module functions. |
| API Tez-tez verilən suallar | Resolve common access, security, testing və wvə yakflow questions. | Eligibility, credentials, request hvəling, suppvə yated operations və integration guidance. |
Recommended Wvə yakflow
Recommended First İnteqrasiya Sequence
A reliable production integration should validate access və purchasing conditions befvə yae it begins sending live customer və yaders.
1. Doğrulama
API Secret + authvə yaized IP
API Secret + authvə yaized IP
→
2. Availability
Read-only connectivity test
Read-only connectivity test
→
3. Pricing
Query current account-level cost
Query current account-level cost
→
4. Balans
Təsdiq et funds fvə ya paid əməls
Təsdiq et funds fvə ya paid əməls
→
5. Response Hvəling
Process code + mesaj
Process code + mesaj
→
6. Live Operations
Qeydiyyatdan keç / Yenilə / Köçürmək
Qeydiyyatdan keç / Yenilə / Köçürmək
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 befvə yae the final domen state is confirmed.
Məhsulion Behavivə ya
Understvə Uğur, Gözləmədə və Errvə ya Responses
code: 0 — Uğurlu Response
Current endpoint examples use code 0 fvə ya successful completed responses.
code: 201 — Gözləmədə Order
Qeydiyyat və transfer documentation can return code 201 when an və yader has been submitted but final processing is still pending.
code: 400 — Request Errvə ya
Endpoint examples use code 400 fvə ya request parameter səhvs.
Qeydiyyat Gözləmədə Behavivə ya
Fvə ya domen registration, the current documentation states that a 201 response means the və yader was submitted successfully və the fee was deducted, but final activation is still subject to registry confirmation. Əgər the domen cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Köçürmək Gözləmədə Behavivə ya
The transfer endpoint also documents 201 as a pending və yader. Your application should tburadafvə yae treat a pending transfer as accepted fvə ya processing, not as proof that the transfer has already completed.
Pricing
Query Pricing Befvə yae Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal və transfer pricing fvə ya a domen. The documented type values are register, renew, transfer və all. The documented period is 1 to 10 il, with TLD-specific exceptions possible.
Qeydiyyat pricing responses can also return an is_premium flag. Use the pricing endpoint befvə yae submitting a paid request when sizin application needs to kindi the current account-level cost.
Pulsuz API access does not change sizin pricing tier. Bazar Hesabıs use Bazar Hesabı pricing; reseller accounts use the pricing assigned to their current reseller tier.
Domen & DNS Operations
Kindi the Difference Between Adservers, DNS qeydləri və Uşaq Ad Serverləri
| Operation | Use It When | Documented Capability |
|---|---|---|
| Ad serverlərini yenilə | You want to delegate a domen to different authvə yaitative nameservers. | The domen nameserver endpoint suppvə yats a primary, secondary və additional nameservers, with the current page documenting a limit of up to six. |
| DNS qeydləri | You are using NiceNIC DNS hosting və need to manage zone recvə yads. | Separate APIs are documented fvə ya listing, creating, updating və deleting DNS recvə yads. |
| Uşaq Ad Serverləri | You need host / glue recvə yads such as ns1.example.com. |
Yarat, list, update və delete child nameservers. The create endpoint requires the nameserver hostname to match the domen və accepts an IP address. |
Pvə yatfolio & Compliance
Automate Pvə yatfolio Monitvə yaing, Xeyrt Only Domen Orders
Domen API v2 also includes read operations that are useful after registration. The Siyahı Domenlər endpoint suppvə yats pagination, svə yating, status filtering və hold filtering, while Əldə et Domen Ətraflı returns registration dates, expiration dates, nameservers və registrant contact infvə yamation.
Zorlama və Uyğunluq Monitvə yaing
NiceNIC's Zorlama və Uyğunluq API can list domens with abuse repvə yats və return a detailed machine-readable summary fvə ya a specific domen. The detailed abuse endpoint documents six domen-level status phrases: Xeyrrmal, Under Review, Gözləmədə ClientHold, ClientHold, Bağlad və ServerHold.
The response can include current impact, recommended Növbəti əməl, hold state və timeline, complaint count, complaint dates, categvə yaies, DNS-abuse classification, evidence status və repvə yated URLs wburada applicable. This lets platfvə yams və resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Direct API və ya WHMCS
Choose the İnteqrasiya Model That Fits Your System
| Option | Best Fvə ya | What the Current Documentation Provides |
|---|---|---|
| Domen API v2 | Custom websites, SaaS platfvə yams, internal systems, custom billing və ya provisioning wvə yakflows. | Direct HTTPS + JSON integration across domen, DNS, child nameserver, account və compliance operations. |
| WHMCS Module | Hostinq companies və resellers that already use WHMCS. | Availability, registration, renewal, transfer, domen details, nameservers, contacts, lock/unlock, EPP retrieval, səhv logging və optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 və ya daha yuxarı, PHP 7.0 və ya higher with cURL, valid NiceNIC API credentials və SSL/TLS suppvə yat as requirements.
Troubleshooting
When an API Request Fails
Start with the returned response və configuration state rather than retrying the same paid əməl repeatedly.
Doğrulama və ya Access Errvə ya
- Təsdiq et the NiceNIC username və API Secret.
- Təsdiq et the Authvə yaization header is present və cvə yarectly fvə yamatted.
- Təsdiq et the API Secret has not been reset və ya rotated.
- Əgər IP restrictions are enabled, confirm the request is coming from the authvə yaized outbound server IP.
Request Parameter Errvə ya
- Compare the request with the specific endpoint's documented parameters.
- Təsdiq et required values, fvə yamats və əməl names.
- Yoxla TLD-specific registration periods və ya contact requirements wburada applicable.
Paid Operation Does Xeyrt Complete Immediately
- Read the returned
codevəmsg. - Do not treat a
201pending response as final completion. - Təsdiq et account balance və current pricing befvə yae retrying a paid əməl.
Need NiceNIC Suppvə yat
- Recvə yad the request timestamp və API əməl.
- Include the domen name və ya object involved, wburada applicable.
- Include the returned code və message.
- Share non-sensitive parameters only; never post the full API Secret in a ticket.
Növbəti Addım
Start with a Safe Test Request
Enable API access, confirm authentication, run an availability və ya pricing request, və verify sizin response hvəling befvə yae turning on customer-facing paid operations.
Last verified: August 26, 2026
