NiceNIC Domen API v2 Documentation & Quick Start
NiceNIC Domen API v2 is available to both Bazar Hesabıs və Distribyutor Accounts. 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.
Bazar Hesabı: API access with Bazar Hesabı pricing.
Distribyutor Account: API access with the pricing assigned to the current reseller tier.
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.
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.
Enable API Access
Açıq API parametrləris, create və ya retrieve sizin API Secret, və configure authvə yaized server IPs wburada applicable.
Təsdiq et Authentication
Use HTTPS with the Authvə yaization header in the fvə yamat username:api_secret.
Run a Safe Test
Start with domen availability, pricing, account balance və ya domen listing.
Hvəle the Response
Read və stvə yae the returned code və msg befvə yae enabling paid production actions.
Recommended First Request: Domen Availability
The availability endpoint suppvə yats multiple domens in one request by separating domen names with commas.
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 |
|---|---|---|
| Əldə etting Started | Connect securely və understvə response hvəling. | API Overview, API Svəbox, Authentication, Response Codes. |
| Domen İdarə etment | Automate the cvə yae domen lifecycle. | Availability, List Domenlər, Domen Ətraflı, Qeydiyyat, Yeniləal, Transfer In, Adservers, Əlaqəs, Pricing. |
| Abuse & Compliance | Monitvə ya domens that require compliance attention. | List domens with abuse repvə yats və retrieve machine-readable abuse status, hold lifecycle, complaint infvə yamation və recommended action. |
| DNS Recvə yads | İdarə et hosted DNS recvə yads programmatically. | List, Yarat, Update və Delete DNS recvə yads. |
| Child Adservers | İdarə et host / glue recvə yads fvə ya nameservers under sizin own domen. | Yarat, List, Update və Delete child nameservers. |
| Account & Billing | Connect automation to account-level checks. | Hesab Balansı və transaction-related account infvə yamation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wvə yakflow. | Availability, Qeydiyyat, Yeniləal, Transfer, 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 First İnteqrasiya Sequence
A reliable production integration should validate access və purchasing conditions befvə yae it begins sending live customer və yaders.
API Secret + authvə yaized IP
Read-only connectivity test
Query current account-level cost
Təsdiq et funds fvə ya paid actions
Process code + msg
Qeydiyyat / Yenilə / Transfer
Understvə Success, Pending və Errvə ya Responses
code: 0 — Uğurlu Response
Current endpoint examples use code 0 fvə ya successful completed responses.
code: 201 — Pending 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 errvə yas.
Qeydiyyat Pending 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.
Transfer Pending 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.
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.
Kindi the Difference Between Adservers, DNS Recvə yads və Child Adservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Update Adservers | 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 Recvə yads | 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. |
| Child Adservers | 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. |
Automate Pvə yatfolio Monitvə yaing, Xeyrt Only Domen Orders
Domen API v2 also includes read operations that are useful after registration. The List 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.
Abuse & Compliance Monitvə yaing
NiceNIC's Abuse & Compliance 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, Pending ClientHold, ClientHold, Bağlad və ServerHold.
The response can include current impact, recommended Növbəti action, 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.
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, errvə ya logging və optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 və ya higher, PHP 7.0 və ya higher with cURL, valid NiceNIC API credentials və SSL/TLS suppvə yat as requirements.
When an API Request Fails
Start with the returned response və configuration state rather than retrying the same paid action repeatedly.
Authentication 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ə action 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 action.
Need NiceNIC Suppvə yat
- Recvə yad the request timestamp və API action.
- 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.
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.
