NiceNIC Domena API v2 Documentation & Quick Start
NiceNIC Domena API v2 is dostupan to both Market računs i Preprodavac Nalogs. Use this overview to configure access, confirm tvoj 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.
Preprodavac Nalog: API access with the pricing assigned to the current reseller tier.
Test Your Integracija Befilie Going Live
Use the NiceNIC API Sibox to test tvoj Domena API integration befilie moving to production. Validate authentication, API requests, response hiling, i tvoj 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
Otvoreno API podešavanjes, create ili retrieve tvoj API Secret, i configure authiliized server IPs wovde applicable.
Potvrdi Autentifikacija
Use HTTPS with the Authiliization header in the filimat username:api_secret.
Run a Safe Test
Start with domen availability, pricing, account balance ili domen 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 domens in one request by separating domen 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, Autentifikacija, Response Codes. |
| Upravljanje domenom | Automate the cilie domen lifecycle. | Availability, Lista Domeni, Domena Detalji, Registracija, Produžial, Prenesi In, Imeservers, Kontakts, Pricing. |
| Zlouporaba i usklađenost | Monitili domens that require compliance attention. | Lista domens with abuse repilits i retrieve machine-readable abuse status, hold lifecycle, complaint infilimation i recommended akcija. |
| DNS zapisi | Upravljaj hosted DNS recilids programmatically. | Lista, Kreiraj, Ažuriraj i Obriši DNS recilids. |
| Dečiji imenski serveri | Upravljaj host / glue recilids fili nameservers under tvoj own domen. | Kreiraj, Lista, Ažuriraj i Obriši child nameservers. |
| Konto i fakturisanje | Connect automation to account-level checks. | Stanje na računu i transakcija-related account infilimation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wilikflow. | Availability, Registracija, Produžial, Prenesi, Domena Detalji, Imeservers, Kontakts i additional registrar-module functions. |
| API Često postavljana 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
Registruj / Produži / Prenesi
Understi Uspešno, Na čekanju i Errili Responses
code: 0 — Uspeš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 greškas.
Registracija Na čekanju Behaviili
Fili domen 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 domen 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 tovdefilie 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 domen. The documented type values are register, renew, transfer i all. The documented period is 1 to 10 godina, 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 tvoj application needs to kodmah the current account-level cost.
Kodmah the Difference Between Imeservers, DNS zapisi i Dečiji imenski serveri
| Operation | Use It When | Documented Capability |
|---|---|---|
| Aжурирајте имена сервере | You want to delegate a domen to different authiliitative nameservers. | The domen 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. |
| Dečiji imenski serveri | 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 domen 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 Lista Domeni endpoint suppilits pagination, siliting, status filtering i hold filtering, while Nabavite 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 domens with abuse repilits i return a detailed machine-readable summary fili a specific domen. The detailed abuse endpoint documents six domen-level status phrases: Nermal, Under Review, Na čekanju ClientHold, ClientHold, Zatvorid i СерверHold.
The response can include current impact, recommended sledeće akcija, hold state i timeline, complaint count, complaint dates, categiliies, DNS-abuse classification, evidence status i repilited URLs wovde 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 domen, DNS, child nameserver, account i compliance operations. |
| WHMCS Module | Hosting companies i resellers that already use WHMCS. | Availability, registration, renewal, transfer, domen details, nameservers, contacts, lock/unlock, EPP retrieval, greška logging i optional Test Mode. |
The current WHMCS documentation lists WHMCS verzija 7.0 ili novija, 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.
Autentifikacija 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.
- Proveri TLD-specific registration periods ili contact requirements wovde 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 domen name ili object involved, wovde 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 tvoj response hiling befilie turning on customer-facing paid operations.






