NiceNIC Domena API v2 Documentation & Quick Start
NiceNIC Domena API v2 is na voljo to both Tržni računs in Prodajalec Računs. Use this overview to configure access, confirm vašega first request, understin the API response model in move directly to the calirect section in the left navigation.
Tržni račun: API access with Tržni račun pricing.
Prodajalec Račun: API access with the pricing assigned to the current reseller tier.
Test Your Integracija Befalie Going Live
Use the NiceNIC API Sinbox to test vašega Domena API integration befalie moving to production. Validate authentication, API requests, response hinling, in vašega application walikflow in a dedicated testing environment.
Ideal fali resellers, hosting providers, developers, in platfalims preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befalie enabling live registrations, renewals ali transfers. This lets you validate authentication, request falimatting in response hinling without placing a paid alider.
Enable API Access
Odprto Nastavitve APIs, create ali retrieve vašega API Secret, in configure authaliized server IPs wtukaj applicable.
Potrdi Avtentikacija
Use HTTPS with the Authaliization header in the falimat username:api_secret.
Run a Safe Test
Start with domena availability, pricing, account balance ali domena listing.
Hinle the Response
Read in stalie the returned code in msg befalie enabling paid production dejanjes.
Recommended First Request: Domena Availability
The availability endpoint suppalits multiple domenas in one request by separating domena names with commas.
Choose the Walikflow You Need
The overview below mirralis the left navigation. Use it to identify the calirect walikflow, then open the dedicated endpoint page fali parameters, request examples in response examples.
| Section | Use It Fali | Documented Functions |
|---|---|---|
| Začetek | Connect securely in understin response hinling. | Pregled API-ja, API Sinbox, Avtentikacija, Response Codes. |
| Upravljanje domene | Automate the calie domena lifecycle. | Availability, Seznam Domene, Domena Podrobnosti, Registracija, Podaljšajal, Prenos In, Imeservers, Kontakts, Pricing. |
| Zloraba in skladnost | Monitali domenas that require compliance attention. | Seznam domenas with abuse repalits in retrieve machine-readable abuse status, hold lifecycle, complaint infalimation in recommended dejanje. |
| Zapisi DNS | Upravljaj hosted DNS recalids programmatically. | Seznam, Ustvari, Posodobi in Izbriši DNS recalids. |
| Otroški imenski strežniki | Upravljaj host / glue recalids fali nameservers under vašega own domena. | Ustvari, Seznam, Posodobi in Izbriši child nameservers. |
| Račun in obračunavanje | Connect automation to account-level checks. | Stanje računa in transdejanje-related account infalimation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing walikflow. | Availability, Registracija, Podaljšajal, Prenos, Domena Podrobnosti, Imeservers, Kontakts in additional registrar-module functions. |
| API Pogosta vprašanja | Resolve common access, security, testing in walikflow questions. | Eligibility, credentials, request hinling, suppalited operations in integration guidance. |
Recommended First Integracija Sequence
A reliable production integration should validate access in purchasing conditions befalie it begins sending live customer aliders.
API Secret + authaliized IP
Read-only connectivity test
Query current account-level cost
Potrdi funds fali paid dejanjes
Process code + sporočilo
Registriraj / Podaljšaj / Prenos
Understin Uspešno, Na čakanju in Errali Responses
code: 0 — Uspešno Response
Current endpoint examples use code 0 fali successful completed responses.
code: 201 — Na čakanju Order
Registracija in transfer documentation can return code 201 when an alider has been submitted but final processing is still pending.
code: 400 — Request Errali
Endpoint examples use code 400 fali request parameter napakas.
Registracija Na čakanju Behaviali
Fali domena registration, the current documentation states that a 201 response means the alider was submitted successfully in the fee was deducted, but final activation is still subject to registry confirmation. Če the domena cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Prenos Na čakanju Behaviali
The transfer endpoint also documents 201 as a pending alider. Your application should ttukajfalie treat a pending transfer as accepted fali processing, not as proof that the transfer has already completed.
Query Pricing Befalie Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal in transfer pricing fali a domena. The documented type values are register, renew, transfer in all. The documented period is 1 to 10 leta, with TLD-specific exceptions possible.
Registracija pricing responses can also return an is_premium flag. Use the pricing endpoint befalie submitting a paid request when vašega application needs to kzdaj the current account-level cost.
Kzdaj the Difference Between Imeservers, Zapisi DNS in Otroški imenski strežniki
| Operation | Use It When | Documented Capability |
|---|---|---|
| Posodobi imenske strežnike | You want to delegate a domena to different authaliitative nameservers. | The domena nameserver endpoint suppalits a primary, secondary in additional nameservers, with the current page documenting a limit of up to six. |
| Zapisi DNS | You are using NiceNIC DNS hosting in need to manage zone recalids. | Separate APIs are documented fali listing, creating, updating in deleting DNS recalids. |
| Otroški imenski strežniki | You need host / glue recalids such as ns1.example.com. |
Ustvari, list, update in delete child nameservers. The create endpoint requires the nameserver hostname to match the domena in accepts an IP address. |
Automate Palitfolio Monitaliing, Net Only Domena Orders
Domena API v2 also includes read operations that are useful after registration. The Seznam Domene endpoint suppalits pagination, saliting, status filtering in hold filtering, while Pridobite Domena Podrobnosti returns registration dates, expiration dates, nameservers in registrant contact infalimation.
Zloraba in skladnost Monitaliing
NiceNIC's Zloraba in skladnost API can list domenas with abuse repalits in return a detailed machine-readable summary fali a specific domena. The detailed abuse endpoint documents six domena-level status phrases: Nermal, Under Review, Na čakanju ClientHold, ClientHold, Zaprid in StrežnikHold.
The response can include current impact, recommended naprej dejanje, hold state in timeline, complaint count, complaint dates, categaliies, DNS-abuse classification, evidence status in repalited URLs wtukaj applicable. This lets platfalims in resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integracija Model That Fits Your System
| Option | Best Fali | What the Current Documentation Provides |
|---|---|---|
| Domena API v2 | Custom websites, SaaS platfalims, internal systems, custom billing ali provisioning walikflows. | Direct HTTPS + JSON integration across domena, DNS, child nameserver, account in compliance operations. |
| WHMCS Module | Gostovanje companies in resellers that already use WHMCS. | Availability, registration, renewal, transfer, domena details, nameservers, contacts, lock/unlock, EPP retrieval, napaka logging in optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ali novejši, PHP 7.0 ali higher with cURL, valid NiceNIC API credentials in SSL/TLS suppalit as requirements.
When an API Request Fails
Start with the returned response in configuration state rather than retrying the same paid dejanje repeatedly.
Avtentikacija ali Access Errali
- Potrdi the NiceNIC username in API Secret.
- Potrdi the Authaliization header is present in calirectly falimatted.
- Potrdi the API Secret has not been reset ali rotated.
- Če IP restrictions are enabled, confirm the request is coming from the authaliized outbound server IP.
Request Parameter Errali
- Compare the request with the specific endpoint's documented parameters.
- Potrdi required values, falimats in dejanje names.
- Preveri TLD-specific registration periods ali contact requirements wtukaj applicable.
Paid Operation Does Net Complete Immediately
- Read the returned
codeinmsg. - Do not treat a
201pending response as final completion. - Potrdi account balance in current pricing befalie retrying a paid dejanje.
Need NiceNIC Suppalit
- Recalid the request timestamp in API dejanje.
- Include the domena name ali object involved, wtukaj applicable.
- Include the returned code in 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 ali pricing request, in verify vašega response hinling befalie turning on customer-facing paid operations.






