NiceNIC Doména API v2 Documentation & Quick Start
NiceNIC Doména API v2 is dostupné to both Marketingový účets a Reseller Účets. Use this overview to configure access, confirm vašeho first request, understa the API response model a move directly to the cneborect section in the left navigation.
Marketingový účet: API access with Marketingový účet pricing.
Reseller Účet: API access with the pricing assigned to the current reseller tier.
Test Your Integrace Befneboe Going Live
Use the NiceNIC API Sabox to test vašeho Doména API integration befneboe moving to production. Validate authentication, API requests, response haling, a vašeho application wnebokflow in a dedicated testing environment.
Ideal fnebo resellers, hosting providers, developers, a platfneboms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befneboe enabling live registrations, renewals nebo transfers. This lets you validate authentication, request fnebomatting a response haling without placing a paid neboder.
Enable API Access
Otevřít Nastavení APIs, create nebo retrieve vašeho API Secret, a configure authneboized server IPs wzde applicable.
Potvrdit Ověření
Use HTTPS with the Authneboization header in the fnebomat username:api_secret.
Run a Safe Test
Start with doména availability, pricing, account balance nebo doména listing.
Hale the Response
Read a stneboe the returned code a msg befneboe enabling paid production akces.
Recommended First Request: Doména Availability
The availability endpoint suppnebots multiple doménas in one request by separating doména names with commas.
Choose the Wnebokflow You Need
The overview below mirrnebos the left navigation. Use it to identify the cneborect wnebokflow, then open the dedicated endpoint page fnebo parameters, request examples a response examples.
| Section | Use It Fnebo | Documented Functions |
|---|---|---|
| Začínáme | Connect securely a understa response haling. | Přehled API, API Sabox, Ověření, Response Codes. |
| Správa domén | Automate the cneboe doména lifecycle. | Availability, Seznam Domény, Doména Detaily, Registrace, Obnovital, Převést In, Jménoservers, Kontakts, Pricing. |
| Zneužívání a dodržování předpisů | Monitnebo doménas that require compliance attention. | Seznam doménas with abuse repnebots a retrieve machine-readable abuse status, hold lifecycle, complaint infnebomation a recommended akce. |
| DNS záznamy | Spravovat hosted DNS recnebods programmatically. | Seznam, Vytvořit, Aktualizovat a Smazat DNS recnebods. |
| Dětské nameservery | Spravovat host / glue recnebods fnebo nameservers under vašeho own doména. | Vytvořit, Seznam, Aktualizovat a Smazat child nameservers. |
| Účet a fakturace | Connect automation to account-level checks. | Zůstatek na účtu a transakce-related account infnebomation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wnebokflow. | Availability, Registrace, Obnovital, Převést, Doména Detaily, Jménoservers, Kontakts a additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing a wnebokflow questions. | Eligibility, credentials, request haling, suppneboted operations a integration guidance. |
Recommended First Integrace Sequence
A reliable production integration should validate access a purchasing conditions befneboe it begins sending live customer neboders.
API Secret + authneboized IP
Read-only connectivity test
Query current account-level cost
Potvrdit funds fnebo paid akces
Process code + msg
Registrovat / Obnovit / Převést
Understa Úspěch, Čeká se a Errnebo Responses
code: 0 — Úspěšné Response
Current endpoint examples use code 0 fnebo successful completed responses.
code: 201 — Čeká se Order
Registrace a transfer documentation can return code 201 when an neboder has been submitted but final processing is still pending.
code: 400 — Request Errnebo
Endpoint examples use code 400 fnebo request parameter chybas.
Registrace Čeká se Behavinebo
Fnebo doména registration, the current documentation states that a 201 response means the neboder was submitted successfully a the fee was deducted, but final activation is still subject to registry confirmation. Pokud the doména cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Převést Čeká se Behavinebo
The transfer endpoint also documents 201 as a pending neboder. Your application should tzdefneboe treat a pending transfer as accepted fnebo processing, not as proof that the transfer has already completed.
Query Pricing Befneboe Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal a transfer pricing fnebo 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.
Registrace pricing responses can also return an is_premium flag. Use the pricing endpoint befneboe submitting a paid request when vašeho application needs to knyní the current account-level cost.
Knyní the Difference Between Jménoservers, DNS záznamy a Dětské nameservery
| Operation | Use It When | Documented Capability |
|---|---|---|
| Aktualizovat nameservery | You want to delegate a doména to different authneboitative nameservers. | The doména nameserver endpoint suppnebots a primary, secondary a additional nameservers, with the current page documenting a limit of up to six. |
| DNS záznamy | You are using NiceNIC DNS hosting a need to manage zone recnebods. | Separate APIs are documented fnebo listing, creating, updating a deleting DNS recnebods. |
| Dětské nameservery | You need host / glue recnebods such as ns1.example.com. |
Vytvořit, list, update a delete child nameservers. The create endpoint requires the nameserver hostname to match the doména a accepts an IP address. |
Automate Pnebotfolio Monitneboing, Net Only Doména Orders
Doména API v2 also includes read operations that are useful after registration. The Seznam Domény endpoint suppnebots pagination, sneboting, status filtering a hold filtering, while Získejte Doména Detaily returns registration dates, expiration dates, nameservers a registrant contact infnebomation.
Zneužívání a dodržování předpisů Monitneboing
NiceNIC's Zneužívání a dodržování předpisů API can list doménas with abuse repnebots a return a detailed machine-readable summary fnebo a specific doména. The detailed abuse endpoint documents six doména-level status phrases: Nermal, Under Review, Čeká se ClientHold, ClientHold, Zavřítd a ServerHold.
The response can include current impact, recommended další akce, hold state a timeline, complaint count, complaint dates, categneboies, DNS-abuse classification, evidence status a repneboted URLs wzde applicable. This lets platfneboms a resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integrace Model That Fits Your System
| Option | Best Fnebo | What the Current Documentation Provides |
|---|---|---|
| Doména API v2 | Custom websites, SaaS platfneboms, internal systems, custom billing nebo provisioning wnebokflows. | 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 nebo novější, PHP 7.0 nebo higher with cURL, valid NiceNIC API credentials a SSL/TLS suppnebot as requirements.
When an API Request Fails
Start with the returned response a configuration state rather than retrying the same paid akce repeatedly.
Ověření nebo Access Errnebo
- Potvrdit the NiceNIC username a API Secret.
- Potvrdit the Authneboization header is present a cneborectly fnebomatted.
- Potvrdit the API Secret has not been reset nebo rotated.
- Pokud IP restrictions are enabled, confirm the request is coming from the authneboized outbound server IP.
Request Parameter Errnebo
- Compare the request with the specific endpoint's documented parameters.
- Potvrdit required values, fnebomats a akce names.
- Zkontrolovat TLD-specific registration periods nebo contact requirements wzde applicable.
Paid Operation Does Net Complete Immediately
- Read the returned
codeamsg. - Do not treat a
201pending response as final completion. - Potvrdit account balance a current pricing befneboe retrying a paid akce.
Need NiceNIC Suppnebot
- Recnebod the request timestamp a API akce.
- Include the doména name nebo object involved, wzde 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 nebo pricing request, a verify vašeho response haling befneboe turning on customer-facing paid operations.






