NiceNIC Domeni API v2 Documentation & Quick Start
NiceNIC Domeni API v2 is në dispozicion to both Llogari Tregus dhe Rishitës Llogarias. Use this overview to configure access, confirm tënd first request, understdhe the API response model dhe move directly to the coserect section in the left navigation.
Llogari Tregu: API access with Llogari Tregu pricing.
Rishitës Llogaria: API access with the pricing assigned to the current reseller tier.
Test Your Integrim Befosee Going Live
Use the NiceNIC API Sdhebox to test tënd Domeni API integration befosee moving to production. Validate authentication, API requests, response hdheling, dhe tënd application wosekflow in a dedicated testing environment.
Ideal fose resellers, hosting providers, developers, dhe platfosems preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befosee enabling live registrations, renewals ose transfers. This lets you validate authentication, request fosematting dhe response hdheling without placing a paid oseder.
Enable API Access
Hapur Cilësime APIs, create ose retrieve tënd API Secret, dhe configure authoseized server IPs wkëtu applicable.
Konfirmo Autentifikimi
Use HTTPS with the Authoseization header in the fosemat username:api_secret.
Run a Safe Test
Start with domain availability, pricing, account balance ose domain listing.
Hdhele the Response
Read dhe stosee the returned code dhe msg befosee enabling paid production veprims.
Recommended First Request: Domeni Availability
The availability endpoint supposets multiple domains in one request by separating domain names with commas.
Choose the Wosekflow You Need
The overview below mirroses the left navigation. Use it to identify the coserect wosekflow, then open the dedicated endpoint page fose parameters, request examples dhe response examples.
| Section | Use It Fose | Documented Functions |
|---|---|---|
| Fillimi | Connect securely dhe understdhe response hdheling. | Përmbledhje e API-së, API Sdhebox, Autentifikimi, Response Codes. |
| Menaxhimi i Domenit | Automate the cosee domain lifecycle. | Availability, Lista Domeinet, Domeni Detajet, Regjistrim, Rinovoal, Transfero In, Emërservers, Kontakts, Pricing. |
| Abuzimi & Përputhshmëria | Monitose domains that require compliance attention. | Lista domains with abuse reposets dhe retrieve machine-readable abuse status, hold lifecycle, complaint infosemation dhe recommended veprim. |
| Rekordet DNS | Menaxho hosted DNS recoseds programmatically. | Lista, Krijo, Përditëso dhe Fshi DNS recoseds. |
| Emra servera për fëmijë | Menaxho host / glue recoseds fose nameservers under tënd own domain. | Krijo, Lista, Përditëso dhe Fshi child nameservers. |
| Llogaria & Faturimi | Connect automation to account-level checks. | Bilanci i Llogarisë dhe transveprim-related account infosemation. |
| API-ja e WHMCS-së | Integrate NiceNIC into an existing WHMCS billing wosekflow. | Availability, Regjistrim, Rinovoal, Transfero, Domeni Detajet, Emërservers, Kontakts dhe additional registrar-module functions. |
| API Pyetjet e Shpeshta | Resolve common access, security, testing dhe wosekflow questions. | Eligibility, credentials, request hdheling, supposeted operations dhe integration guidance. |
Recommended First Integrim Sequence
A reliable production integration should validate access dhe purchasing conditions befosee it begins sending live customer oseders.
API Secret + authoseized IP
Read-only connectivity test
Query current account-level cost
Konfirmo funds fose paid veprims
Process code + mesazh
Regjistro / Rinovo / Transfero
Understdhe Sukses, Në pritje dhe Errose Responses
code: 0 — I Suksesshëm Response
Current endpoint examples use code 0 fose successful completed responses.
code: 201 — Në pritje Order
Regjistrim dhe transfer documentation can return code 201 when an oseder has been submitted but final processing is still pending.
code: 400 — Request Errose
Endpoint examples use code 400 fose request parameter gabims.
Regjistrim Në pritje Behaviose
Fose domain registration, the current documentation states that a 201 response means the oseder was submitted successfully dhe the fee was deducted, but final activation is still subject to registry confirmation. Nëse the domain cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transfero Në pritje Behaviose
The transfer endpoint also documents 201 as a pending oseder. Your application should tkëtufosee treat a pending transfer as accepted fose processing, not as proof that the transfer has already completed.
Query Pricing Befosee Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal dhe transfer pricing fose a domain. The documented type values are register, renew, transfer dhe all. The documented period is 1 to 10 vite, with TLD-specific exceptions possible.
Regjistrim pricing responses can also return an is_premium flag. Use the pricing endpoint befosee submitting a paid request when tënd application needs to ktani the current account-level cost.
Ktani the Difference Between Emërservers, Rekordet DNS dhe Emra servera për fëmijë
| Operation | Use It When | Documented Capability |
|---|---|---|
| Përditëso Serverët e Emrave | You want to delegate a domain to different authoseitative nameservers. | The domain nameserver endpoint supposets a primary, secondary dhe additional nameservers, with the current page documenting a limit of up to six. |
| Rekordet DNS | You are using NiceNIC DNS hosting dhe need to manage zone recoseds. | Separate APIs are documented fose listing, creating, updating dhe deleting DNS recoseds. |
| Emra servera për fëmijë | You need host / glue recoseds such as ns1.example.com. |
Krijo, list, update dhe delete child nameservers. The create endpoint requires the nameserver hostname to match the domain dhe accepts an IP address. |
Automate Posetfolio Monitoseing, Jot Only Domeni Orders
Domeni API v2 also includes read operations that are useful after registration. The Lista Domeinet endpoint supposets pagination, soseting, status filtering dhe hold filtering, while Merr Domeni Detajet returns registration dates, expiration dates, nameservers dhe registrant contact infosemation.
Abuzimi & Përputhshmëria Monitoseing
NiceNIC's Abuzimi & Përputhshmëria API can list domains with abuse reposets dhe return a detailed machine-readable summary fose a specific domain. The detailed abuse endpoint documents six domain-level status phrases: Jormal, Under Review, Në pritje ClientHold, ClientHold, Mbylld dhe ShërbimiHold.
The response can include current impact, recommended tjetër veprim, hold state dhe timeline, complaint count, complaint dates, categoseies, DNS-abuse classification, evidence status dhe reposeted URLs wkëtu applicable. This lets platfosems dhe resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the Integrim Model That Fits Your System
| Option | Best Fose | What the Current Documentation Provides |
|---|---|---|
| Domeni API v2 | Custom websites, SaaS platfosems, internal systems, custom billing ose provisioning wosekflows. | Direct HTTPS + JSON integration across domain, DNS, child nameserver, account dhe compliance operations. |
| WHMCS Module | Hosting companies dhe resellers that already use WHMCS. | Availability, registration, renewal, transfer, domain details, nameservers, contacts, lock/unlock, EPP retrieval, gabim logging dhe optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ose më i ri, PHP 7.0 ose higher with cURL, valid NiceNIC API credentials dhe SSL/TLS supposet as requirements.
When an API Request Fails
Start with the returned response dhe configuration state rather than retrying the same paid veprim repeatedly.
Autentifikimi ose Access Errose
- Konfirmo the NiceNIC username dhe API Secret.
- Konfirmo the Authoseization header is present dhe coserectly fosematted.
- Konfirmo the API Secret has not been reset ose rotated.
- Nëse IP restrictions are enabled, confirm the request is coming from the authoseized outbound server IP.
Request Parameter Errose
- Compare the request with the specific endpoint's documented parameters.
- Konfirmo required values, fosemats dhe veprim names.
- Kontrollo TLD-specific registration periods ose contact requirements wkëtu applicable.
Paid Operation Does Jot Complete Immediately
- Read the returned
codedhemsg. - Do not treat a
201pending response as final completion. - Konfirmo account balance dhe current pricing befosee retrying a paid veprim.
Need NiceNIC Supposet
- Recosed the request timestamp dhe API veprim.
- Include the domain name ose object involved, wkëtu applicable.
- Include the returned code dhe 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 ose pricing request, dhe verify tënd response hdheling befosee turning on customer-facing paid operations.






