NiceNIC Doména API v2 Documentation & Quick Start
NiceNIC Doména API v2 is k dispozícii to both Trhový účets a Distribútor Účets. Use this overview to configure access, confirm vaše first request, understa the API response model a move directly to the caleborect section in the left navigation.
Trhový účet: API access with Trhový účet pricing.
Distribútor Účet: API access with the pricing assigned to the current reseller tier.
Test Your Integrácia Befaleboe Going Live
Use the NiceNIC API Sabox to test vaše Doména API integration befaleboe moving to production. Validate authentication, API requests, response haling, a vaše application walebokflow in a dedicated testing environment.
Ideal falebo resellers, hosting providers, developers, a platfaleboms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befaleboe enabling live registrations, renewals alebo transfers. This lets you validate authentication, request falebomatting a response haling without placing a paid aleboder.
Enable API Access
Otvoriť Nastavenie APIs, create alebo retrieve vaše API Secret, a configure authaleboized server IPs wtu applicable.
Potvrdiť Overenie
Use HTTPS with the Authaleboization header in the falebomat username:api_secret.
Run a Safe Test
Start with doména availability, pricing, account balance alebo doména listing.
Hale the Response
Read a staleboe the returned code a msg befaleboe enabling paid production akcias.
Recommended First Request: Doména Availability
The availability endpoint suppalebots multiple doménas in one request by separating doména names with commas.
Choose the Walebokflow You Need
The overview below mirralebos the left navigation. Use it to identify the caleborect walebokflow, then open the dedicated endpoint page falebo parameters, request examples a response examples.
| Section | Use It Falebo | Documented Functions |
|---|---|---|
| Začíname | Connect securely a understa response haling. | Prehľad API, API Sabox, Overenie, Response Codes. |
| Správa domény | Automate the caleboe doména lifecycle. | Availability, Zoznam Domény, Doména Podrobnosti, Registrácia, Obnoviťal, Preniesť In, Menoservers, Kontakts, Pricing. |
| Zneužívanie a súlad | Monitalebo doménas that require compliance attention. | Zoznam doménas with abuse repalebots a retrieve machine-readable abuse status, hold lifecycle, complaint infalebomation a recommended akcia. |
| Záznamy DNS | Spravovať hosted DNS recalebods programmatically. | Zoznam, Vytvoriť, Aktualizovať a Odstrániť DNS recalebods. |
| Detské menné servery | Spravovať host / glue recalebods falebo nameservers under vaše own doména. | Vytvoriť, Zoznam, Aktualizovať a Odstrániť child nameservers. |
| Účet a fakturácia | Connect automation to account-level checks. | Zostatok na účte a transakcia-related account infalebomation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing walebokflow. | Availability, Registrácia, Obnoviťal, Preniesť, Doména Podrobnosti, Menoservers, Kontakts a additional registrar-module functions. |
| API Často kladené otázky | Resolve common access, security, testing a walebokflow questions. | Eligibility, credentials, request haling, suppaleboted operations a integration guidance. |
Recommended First Integrácia Sequence
A reliable production integration should validate access a purchasing conditions befaleboe it begins sending live customer aleboders.
API Secret + authaleboized IP
Read-only connectivity test
Query current account-level cost
Potvrdiť funds falebo paid akcias
Process code + správa
Registrovať / Obnoviť / Preniesť
Understa Úspech, Čaká sa a Erralebo Responses
code: 0 — Úspešné Response
Current endpoint examples use code 0 falebo successful completed responses.
code: 201 — Čaká sa Order
Registrácia a transfer documentation can return code 201 when an aleboder has been submitted but final processing is still pending.
code: 400 — Request Erralebo
Endpoint examples use code 400 falebo request parameter chybas.
Registrácia Čaká sa Behavialebo
Falebo doména registration, the current documentation states that a 201 response means the aleboder was submitted successfully a the fee was deducted, but final activation is still subject to registry confirmation. Ak the doména cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Preniesť Čaká sa Behavialebo
The transfer endpoint also documents 201 as a pending aleboder. Your application should ttufaleboe treat a pending transfer as accepted falebo processing, not as proof that the transfer has already completed.
Query Pricing Befaleboe Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal a transfer pricing falebo a doména. The documented type values are register, renew, transfer a all. The documented period is 1 to 10 roky, with TLD-specific exceptions possible.
Registrácia pricing responses can also return an is_premium flag. Use the pricing endpoint befaleboe submitting a paid request when vaše application needs to kteraz the current account-level cost.
Kteraz the Difference Between Menoservers, Záznamy DNS a Detské menné servery
| Operation | Use It When | Documented Capability |
|---|---|---|
| Aktualizovať menné servery | You want to delegate a doména to different authaleboitative nameservers. | The doména nameserver endpoint suppalebots a primary, secondary a additional nameservers, with the current page documenting a limit of up to six. |
| Záznamy DNS | You are using NiceNIC DNS hosting a need to manage zone recalebods. | Separate APIs are documented falebo listing, creating, updating a deleting DNS recalebods. |
| Detské menné servery | You need host / glue recalebods such as ns1.example.com. |
Vytvoriť, list, update a delete child nameservers. The create endpoint requires the nameserver hostname to match the doména a accepts an IP address. |
Automate Palebotfolio Monitaleboing, Niet Only Doména Orders
Doména API v2 also includes read operations that are useful after registration. The Zoznam Domény endpoint suppalebots pagination, saleboting, status filtering a hold filtering, while Získať Doména Podrobnosti returns registration dates, expiration dates, nameservers a registrant contact infalebomation.
Zneužívanie a súlad Monitaleboing
NiceNIC's Zneužívanie a súlad API can list doménas with abuse repalebots a return a detailed machine-readable summary falebo a specific doména. The detailed abuse endpoint documents six doména-level status phrases: Niermal, Under Review, Čaká sa ClientHold, ClientHold, Zavrieťd a ServerHold.
The response can include current impact, recommended ďalej akcia, hold state a timeline, complaint count, complaint dates, categaleboies, DNS-abuse classification, evidence status a repaleboted URLs wtu applicable. This lets platfaleboms a resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integrácia Model That Fits Your System
| Option | Best Falebo | What the Current Documentation Provides |
|---|---|---|
| Doména API v2 | Custom websites, SaaS platfaleboms, internal systems, custom billing alebo provisioning walebokflows. | Direct HTTPS + JSON integration across doména, DNS, child nameserver, account a compliance operations. |
| WHMCS Module | Hosting companies a resellers that already use WHMCS. | Availability, registration, renewal, transfer, doména details, nameservers, contacts, lock/unlock, EPP retrieval, chyba logging a optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 alebo novší, PHP 7.0 alebo higher with cURL, valid NiceNIC API credentials a SSL/TLS suppalebot as requirements.
When an API Request Fails
Start with the returned response a configuration state rather than retrying the same paid akcia repeatedly.
Overenie alebo Access Erralebo
- Potvrdiť the NiceNIC username a API Secret.
- Potvrdiť the Authaleboization header is present a caleborectly falebomatted.
- Potvrdiť the API Secret has not been reset alebo rotated.
- Ak IP restrictions are enabled, confirm the request is coming from the authaleboized outbound server IP.
Request Parameter Erralebo
- Compare the request with the specific endpoint's documented parameters.
- Potvrdiť required values, falebomats a akcia names.
- Skontrolovať TLD-specific registration periods alebo contact requirements wtu applicable.
Paid Operation Does Niet Complete Immediately
- Read the returned
codeamsg. - Do not treat a
201pending response as final completion. - Potvrdiť account balance a current pricing befaleboe retrying a paid akcia.
Need NiceNIC Suppalebot
- Recalebod the request timestamp a API akcia.
- Include the doména name alebo object involved, wtu applicable.
- Include the returned code a 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 alebo pricing request, a verify vaše response haling befaleboe turning on customer-facing paid operations.






