NiceNIC Domena API v2 Documentation & Quick Start
NiceNIC Domena API v2 is dostupno to both Market računs i Preprodavač Računs. Use this overview to configure access, confirm vaš first request, understi the API response model i move directly to the cilirect section in the left navigation.
Market račun: API access with Market račun pricing.
Preprodavač Račun: API access with the pricing assigned to the current reseller tier.
Test Your Integracija Befilie Going Live
Use the NiceNIC API Sibox to test vaš Domena API integration befilie moving to production. Validate authentication, API requests, response hiling, i vaš application wilikflow in a dedicated testing environment.
Ideal fili resellers, hosting providers, developers, i platfilims preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befilie enabling live registrations, renewals ili transfers. This lets you validate authentication, request filimatting i response hiling without placing a paid ilider.
Enable API Access
Otvori API postavkes, create ili retrieve vaš API Secret, i configure authiliized server IPs wovdje applicable.
Potvrdi Potvrda identiteta
Use HTTPS with the Authiliization header in the filimat username:api_secret.
Run a Safe Test
Start with domena availability, pricing, account balance ili domena listing.
Hile the Response
Read i stilie the returned code i msg befilie enabling paid production akcijas.
Recommended First Request: Domena Availability
The availability endpoint suppilits multiple domenas in one request by separating domena names with commas.
Choose the Wilikflow You Need
The overview below mirrilis the left navigation. Use it to identify the cilirect wilikflow, then open the dedicated endpoint page fili parameters, request examples i response examples.
| Section | Use It Fili | Documented Functions |
|---|---|---|
| Početak rada | Connect securely i understi response hiling. | Pregled API-ja, API Sibox, Potvrda identiteta, Response Codes. |
| Upravljanje domenama | Automate the cilie domena lifecycle. | Availability, Popis Domene, Domena Detalji, Registracija, Produžial, Prenesi In, Nazivservers, Kontakts, Pricing. |
| Zlouporaba i usklađenost | Monitili domenas that require compliance attention. | Popis domenas with abuse repilits i retrieve machine-readable abuse status, hold lifecycle, complaint infilimation i recommended akcija. |
| DNS zapisi | Upravljanje hosted DNS recilids programmatically. | Popis, Kreiraj, Ažuriraj i Izbriši DNS recilids. |
| Dječji poslužitelji imena | Upravljanje host / glue recilids fili nameservers under vaš own domena. | Kreiraj, Popis, Ažuriraj i Izbriši child nameservers. |
| Račun i naplata | Connect automation to account-level checks. | Stanje računa i transakcija-related account infilimation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wilikflow. | Availability, Registracija, Produžial, Prenesi, Domena Detalji, Nazivservers, Kontakts i additional registrar-module functions. |
| API Česta pitanja | Resolve common access, security, testing i wilikflow questions. | Eligibility, credentials, request hiling, suppilited operations i integration guidance. |
Recommended First Integracija Sequence
A reliable production integration should validate access i purchasing conditions befilie it begins sending live customer iliders.
API Secret + authiliized IP
Read-only connectivity test
Query current account-level cost
Potvrdi funds fili paid akcijas
Process code + poruka
Registriraj / Produži / Prenesi
Understi Uspjeh, Na čekanju i Errili Responses
code: 0 — Uspješno Response
Current endpoint examples use code 0 fili successful completed responses.
code: 201 — Na čekanju Order
Registracija i transfer documentation can return code 201 when an ilider has been submitted but final processing is still pending.
code: 400 — Request Errili
Endpoint examples use code 400 fili request parameter pogreškas.
Registracija Na čekanju Behaviili
Fili domena registration, the current documentation states that a 201 response means the ilider was submitted successfully i the fee was deducted, but final activation is still subject to registry confirmation. Ako the domena cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Prenesi Na čekanju Behaviili
The transfer endpoint also documents 201 as a pending ilider. Your application should tovdjefilie treat a pending transfer as accepted fili processing, not as proof that the transfer has already completed.
Query Pricing Befilie Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal i transfer pricing fili a domena. The documented type values are register, renew, transfer i all. The documented period is 1 to 10 godine, with TLD-specific exceptions possible.
Registracija pricing responses can also return an is_premium flag. Use the pricing endpoint befilie submitting a paid request when vaš application needs to ksada the current account-level cost.
Ksada the Difference Between Nazivservers, DNS zapisi i Dječji poslužitelji imena
| Operation | Use It When | Documented Capability |
|---|---|---|
| Ažuriraj poslužitelje imena | You want to delegate a domena to different authiliitative nameservers. | The domena nameserver endpoint suppilits a primary, secondary i additional nameservers, with the current page documenting a limit of up to six. |
| DNS zapisi | You are using NiceNIC DNS hosting i need to manage zone recilids. | Separate APIs are documented fili listing, creating, updating i deleting DNS recilids. |
| Dječji poslužitelji imena | You need host / glue recilids such as ns1.example.com. |
Kreiraj, list, update i delete child nameservers. The create endpoint requires the nameserver hostname to match the domena i accepts an IP address. |
Automate Pilitfolio Monitiliing, Net Only Domena Orders
Domena API v2 also includes read operations that are useful after registration. The Popis Domene endpoint suppilits pagination, siliting, status filtering i hold filtering, while Dobijte Domena Detalji returns registration dates, expiration dates, nameservers i registrant contact infilimation.
Zlouporaba i usklađenost Monitiliing
NiceNIC's Zlouporaba i usklađenost API can list domenas with abuse repilits i return a detailed machine-readable summary fili a specific domena. The detailed abuse endpoint documents six domena-level status phrases: Nermal, Under Review, Na čekanju ClientHold, ClientHold, Zatvorid i PoslužiteljHold.
The response can include current impact, recommended sljedeće akcija, hold state i timeline, complaint count, complaint dates, categiliies, DNS-abuse classification, evidence status i repilited URLs wovdje applicable. This lets platfilims i 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 Fili | What the Current Documentation Provides |
|---|---|---|
| Domena API v2 | Custom websites, SaaS platfilims, internal systems, custom billing ili provisioning wilikflows. | Direct HTTPS + JSON integration across domena, DNS, child nameserver, account i compliance operations. |
| WHMCS Module | Hosting companies i resellers that already use WHMCS. | Availability, registration, renewal, transfer, domena details, nameservers, contacts, lock/unlock, EPP retrieval, pogreška logging i optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ili noviji, PHP 7.0 ili higher with cURL, valid NiceNIC API credentials i SSL/TLS suppilit as requirements.
When an API Request Fails
Start with the returned response i configuration state rather than retrying the same paid akcija repeatedly.
Potvrda identiteta ili Access Errili
- Potvrdi the NiceNIC username i API Secret.
- Potvrdi the Authiliization header is present i cilirectly filimatted.
- Potvrdi the API Secret has not been reset ili rotated.
- Ako IP restrictions are enabled, confirm the request is coming from the authiliized outbound server IP.
Request Parameter Errili
- Compare the request with the specific endpoint's documented parameters.
- Potvrdi required values, filimats i akcija names.
- Provjeri TLD-specific registration periods ili contact requirements wovdje applicable.
Paid Operation Does Net Complete Immediately
- Read the returned
codeimsg. - Do not treat a
201pending response as final completion. - Potvrdi account balance i current pricing befilie retrying a paid akcija.
Need NiceNIC Suppilit
- Recilid the request timestamp i API akcija.
- Include the domena name ili object involved, wovdje applicable.
- Include the returned code i 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 ili pricing request, i verify vaš response hiling befilie turning on customer-facing paid operations.






