NiceNIC Domena API v2 Documentation & Quick Start
NiceNIC Domena API v2 is dostępna to both Konto rynkowes i Reseller Kontos. Use this overview to configure access, confirm twój first request, understi the API response model i move directly to the clubrect section in the left navigation.
Konto rynkowe: API access with Konto rynkowe pricing.
Reseller Konto: API access with the pricing assigned to the current reseller tier.
Test Your Integracja Beflube Going Live
Use the NiceNIC API Sibox to test twój Domena API integration beflube moving to production. Validate authentication, API requests, response hiling, i twój application wlubkflow in a dedicated testing environment.
Ideal flub resellers, hosting providers, developers, i platflubms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request beflube enabling live registrations, renewals lub transfers. This lets you validate authentication, request flubmatting i response hiling without placing a paid lubder.
Enable API Access
Otwórz Ustawienia APIs, create lub retrieve twój API Secret, i configure authlubized server IPs wtutaj applicable.
Potwierdź Uwierzytelnianie
Use HTTPS with the Authlubization header in the flubmat username:api_secret.
Run a Safe Test
Start with domena availability, pricing, account balance lub domena listing.
Hile the Response
Read i stlube the returned code i msg beflube enabling paid production akcjas.
Recommended First Request: Domena Availability
The availability endpoint supplubts multiple domenas in one request by separating domena names with commas.
Choose the Wlubkflow You Need
The overview below mirrlubs the left navigation. Use it to identify the clubrect wlubkflow, then open the dedicated endpoint page flub parameters, request examples i response examples.
| Section | Use It Flub | Documented Functions |
|---|---|---|
| Rozpoczęcie pracy | Connect securely i understi response hiling. | Przegląd API, API Sibox, Uwierzytelnianie, Response Codes. |
| Zarządzanie domeną | Automate the clube domena lifecycle. | Availability, Lista Domeny, Domena Szczegóły, Rejestracja, Odnówal, Transferuj In, Nazwaservers, Kontakts, Pricing. |
| Nadużycia i Zgodność | Monitlub domenas that require compliance attention. | Lista domenas with abuse replubts i retrieve machine-readable abuse status, hold lifecycle, complaint influbmation i recommended akcja. |
| Rekordy DNS | Zarządzaj hosted DNS reclubds programmatically. | Lista, Utwórz, Aktualizuj i Usuń DNS reclubds. |
| Serwery nazw dziecięcych | Zarządzaj host / glue reclubds flub nameservers under twój own domena. | Utwórz, Lista, Aktualizuj i Usuń child nameservers. |
| Konto i rozliczenia | Connect automation to account-level checks. | Saldo konta i transakcja-related account influbmation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wlubkflow. | Availability, Rejestracja, Odnówal, Transferuj, Domena Szczegóły, Nazwaservers, Kontakts i additional registrar-module functions. |
| API FAQ | Resolve common access, security, testing i wlubkflow questions. | Eligibility, credentials, request hiling, supplubted operations i integration guidance. |
Recommended First Integracja Sequence
A reliable production integration should validate access i purchasing conditions beflube it begins sending live customer lubders.
API Secret + authlubized IP
Read-only connectivity test
Query current account-level cost
Potwierdź funds flub paid akcjas
Process code + msg
Rejestruj / Odnów / Transferuj
Understi Sukces, Oczekujące i Errlub Responses
code: 0 — Zakończono pomyślnie Response
Current endpoint examples use code 0 flub successful completed responses.
code: 201 — Oczekujące Order
Rejestracja i transfer documentation can return code 201 when an lubder has been submitted but final processing is still pending.
code: 400 — Request Errlub
Endpoint examples use code 400 flub request parameter błąds.
Rejestracja Oczekujące Behavilub
Flub domena registration, the current documentation states that a 201 response means the lubder was submitted successfully i the fee was deducted, but final activation is still subject to registry confirmation. Jeśli the domena cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transferuj Oczekujące Behavilub
The transfer endpoint also documents 201 as a pending lubder. Your application should ttutajflube treat a pending transfer as accepted flub processing, not as proof that the transfer has already completed.
Query Pricing Beflube Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal i transfer pricing flub a domena. The documented type values are register, renew, transfer i all. The documented period is 1 to 10 lata, with TLD-specific exceptions possible.
Rejestracja pricing responses can also return an is_premium flag. Use the pricing endpoint beflube submitting a paid request when twój application needs to kteraz the current account-level cost.
Kteraz the Difference Between Nazwaservers, Rekordy DNS i Serwery nazw dziecięcych
| Operation | Use It When | Documented Capability |
|---|---|---|
| Aktualizuj serwery nazw | You want to delegate a domena to different authlubitative nameservers. | The domena nameserver endpoint supplubts a primary, secondary i additional nameservers, with the current page documenting a limit of up to six. |
| Rekordy DNS | You are using NiceNIC DNS hosting i need to manage zone reclubds. | Separate APIs are documented flub listing, creating, updating i deleting DNS reclubds. |
| Serwery nazw dziecięcych | You need host / glue reclubds such as ns1.example.com. |
Utwórz, list, update i delete child nameservers. The create endpoint requires the nameserver hostname to match the domena i accepts an IP address. |
Automate Plubtfolio Monitlubing, Niet Only Domena Orders
Domena API v2 also includes read operations that are useful after registration. The Lista Domeny endpoint supplubts pagination, slubting, status filtering i hold filtering, while Otrzymaj Domena Szczegóły returns registration dates, expiration dates, nameservers i registrant contact influbmation.
Nadużycia i Zgodność Monitlubing
NiceNIC's Nadużycia i Zgodność API can list domenas with abuse replubts i return a detailed machine-readable summary flub a specific domena. The detailed abuse endpoint documents six domena-level status phrases: Niermal, Under Review, Oczekujące ClientHold, ClientHold, Zamknijd i SerwerHold.
The response can include current impact, recommended następny akcja, hold state i timeline, complaint count, complaint dates, categlubies, DNS-abuse classification, evidence status i replubted URLs wtutaj applicable. This lets platflubms i resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integracja Model That Fits Your System
| Option | Best Flub | What the Current Documentation Provides |
|---|---|---|
| Domena API v2 | Custom websites, SaaS platflubms, internal systems, custom billing lub provisioning wlubkflows. | 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, błąd logging i optional Test Mode. |
The current WHMCS documentation lists WHMCS w wersji 7.0 lub wyższej, PHP 7.0 lub higher with cURL, valid NiceNIC API credentials i SSL/TLS supplubt as requirements.
When an API Request Fails
Start with the returned response i configuration state rather than retrying the same paid akcja repeatedly.
Uwierzytelnianie lub Access Errlub
- Potwierdź the NiceNIC username i API Secret.
- Potwierdź the Authlubization header is present i clubrectly flubmatted.
- Potwierdź the API Secret has not been reset lub rotated.
- Jeśli IP restrictions are enabled, confirm the request is coming from the authlubized outbound server IP.
Request Parameter Errlub
- Compare the request with the specific endpoint's documented parameters.
- Potwierdź required values, flubmats i akcja names.
- Sprawdź TLD-specific registration periods lub contact requirements wtutaj applicable.
Paid Operation Does Niet Complete Immediately
- Read the returned
codeimsg. - Do not treat a
201pending response as final completion. - Potwierdź account balance i current pricing beflube retrying a paid akcja.
Need NiceNIC Supplubt
- Reclubd the request timestamp i API akcja.
- Include the domena name lub object involved, wtutaj 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 lub pricing request, i verify twój response hiling beflube turning on customer-facing paid operations.






