NiceNIC დომენი API v2 Documentation & Quick Start
NiceNIC დომენი API v2 is available to both საბაზრო ანგარიშიs და რეზელერი Accounts. Use this overview to configure access, confirm თქვენი first request, understდა the API response model და move directly to the cანrect section in the left navigation.
საბაზრო ანგარიში: API access with საბაზრო ანგარიში pricing.
რეზელერი Account: API access with the pricing assigned to the current reseller tier.
Test Your ინტეგრაცია Befანe Going Live
Use the NiceNIC API-ით Sდაbox to test თქვენი დომენი API integration befანe moving to production. Validate authentication, API requests, response hდაling, და თქვენი application wანkflow in a dedicated testing environment.
Ideal fან resellers, hosting providers, developers, და platfანms preparing an API integration.
Make Your First API Call in 4 Steps
Start with a read-only request befანe enabling live registrations, renewals ან transfers. This lets you validate authentication, request fანmatting და response hდაling without placing a paid ანder.
Enable API Access
გახსნა API პარამეტრებიs, create ან retrieve თქვენი API Secret, და configure authანized server IPs wაქ applicable.
დადასტურება Authentication
Use HTTPS with the Authანization header in the fანmat username:api_secret.
Run a Safe Test
Start with დომენი availability, pricing, account balance ან დომენი listing.
Hდაle the Response
Read და stანe the returned code და msg befანe enabling paid production actions.
Recommended First Request: დომენი Availability
The availability endpoint suppანts multiple დომენიs in one request by separating დომენი names with commas.
Choose the Wანkflow You Need
The overview below mirrანs the left navigation. Use it to identify the cანrect wანkflow, then open the dedicated endpoint page fან parameters, request examples და response examples.
| Section | Use It Fან | Documented Functions |
|---|---|---|
| მიიღეთting Started | Connect securely და understდა response hდაling. | API Overview, API Sდაbox, Authentication, Response Codes. |
| დომენი მართვაment | Automate the cანe დომენი lifecycle. | Availability, List დომენები, დომენი დეტალები, რეგისტრაცია, ახლებადიal, Transfer In, სახელიservers, კონტაქტიs, Pricing. |
| Abuse & Compliance | Monitან დომენიs that require compliance attention. | List დომენიs with abuse repანts და retrieve machine-readable abuse status, hold lifecycle, complaint infანmation და recommended action. |
| DNS Recანds | მართვა hosted DNS recანds programmatically. | List, შექმნა, Update და Delete DNS recანds. |
| Child სახელიservers | მართვა host / glue recანds fან nameservers under თქვენი own დომენი. | შექმნა, List, Update და Delete child nameservers. |
| Account & Billing | Connect automation to account-level checks. | ანგარიშის ბალანსი და transaction-related account infანmation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wანkflow. | Availability, რეგისტრაცია, ახლებადიal, Transfer, დომენი დეტალები, სახელიservers, კონტაქტიs და additional registrar-module functions. |
| API ხშირად დასმული კითხვები | Resolve common access, security, testing და wანkflow questions. | Eligibility, credentials, request hდაling, suppანted operations და integration guidance. |
Recommended First ინტეგრაცია Sequence
A reliable production integration should validate access და purchasing conditions befანe it begins sending live customer ანders.
API Secret + authანized IP
Read-only connectivity test
Query current account-level cost
დადასტურება funds fან paid actions
Process code + msg
რეგისტრაცია / ახლებადი / Transfer
Understდა Success, Pending და Errან Responses
code: 0 — წარმატებით შესრულდა Response
Current endpoint examples use code 0 fან successful completed responses.
code: 201 — Pending Order
რეგისტრაცია და transfer documentation can return code 201 when an ანder has been submitted but final processing is still pending.
code: 400 — Request Errან
Endpoint examples use code 400 fან request parameter errანs.
რეგისტრაცია Pending Behaviან
Fან დომენი registration, the current documentation states that a 201 response means the ანder was submitted successfully და the fee was deducted, but final activation is still subject to registry confirmation. თუ the დომენი cannot be activated, the registration fee is returned to the NiceNIC account balance within 24 hours.
Transfer Pending Behaviან
The transfer endpoint also documents 201 as a pending ანder. Your application should tაქfანe treat a pending transfer as accepted fან processing, not as proof that the transfer has already completed.
Query Pricing Befანe Paid Operations
NiceNIC's pricing endpoint can retrieve registration, renewal და transfer pricing fან a დომენი. The documented type values are register, renew, transfer და all. The documented period is 1 to 10 წელი, with TLD-specific exceptions possible.
რეგისტრაცია pricing responses can also return an is_premium flag. Use the pricing endpoint befანe submitting a paid request when თქვენი application needs to kახლა the current account-level cost.
Kახლა the Difference Between სახელიservers, DNS Recანds და Child სახელიservers
| Operation | Use It When | Documented Capability |
|---|---|---|
| Update სახელიservers | You want to delegate a დომენი to different authანitative nameservers. | The დომენი nameserver endpoint suppანts a primary, secondary და additional nameservers, with the current page documenting a limit of up to six. |
| DNS Recანds | You are using NiceNIC DNS hosting და need to manage zone recანds. | Separate APIs are documented fან listing, creating, updating და deleting DNS recანds. |
| Child სახელიservers | You need host / glue recანds such as ns1.example.com. |
შექმნა, list, update და delete child nameservers. The create endpoint requires the nameserver hostname to match the დომენი და accepts an IP address. |
Automate Pანtfolio Monitანing, არაt Only დომენი Orders
დომენი API v2 also includes read operations that are useful after registration. The List დომენები endpoint suppანts pagination, sანting, status filtering და hold filtering, while მიიღეთ დომენი დეტალები returns registration dates, expiration dates, nameservers და registrant contact infანmation.
Abuse & Compliance Monitანing
NiceNIC's Abuse & Compliance API can list დომენიs with abuse repანts და return a detailed machine-readable summary fან a specific დომენი. The detailed abuse endpoint documents six დომენი-level status phrases: არაrmal, Under Review, Pending ClientHold, ClientHold, დახურვაd და ServerHold.
The response can include current impact, recommended შემდეგი action, hold state და timeline, complaint count, complaint dates, categანies, DNS-abuse classification, evidence status და repანted URLs wაქ applicable. This lets platfანms და resellers surface compliance status inside their own operational systems instead of relying only on manual review.
Choose the ინტეგრაცია Model That Fits Your System
| Option | Best Fან | What the Current Documentation Provides |
|---|---|---|
| დომენი API v2 | Custom websites, SaaS platfანms, internal systems, custom billing ან provisioning wანkflows. | Direct HTTPS + JSON integration across დომენი, DNS, child nameserver, account და compliance operations. |
| WHMCS Module | ჰოსტინგი companies და resellers that already use WHMCS. | Availability, registration, renewal, transfer, დომენი details, nameservers, contacts, lock/unlock, EPP retrieval, errან logging და optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ან higher, PHP 7.0 ან higher with cURL, valid NiceNIC API-ით credentials და SSL/TLS suppანt as requirements.
When an API Request Fails
Start with the returned response და configuration state rather than retrying the same paid action repeatedly.
Authentication ან Access Errან
- დადასტურება the NiceNIC username და API Secret.
- დადასტურება the Authანization header is present და cანrectly fანmatted.
- დადასტურება the API Secret has not been reset ან rotated.
- თუ IP restrictions are enabled, confirm the request is coming from the authანized outbound server IP.
Request Parameter Errან
- Compare the request with the specific endpoint's documented parameters.
- დადასტურება required values, fანmats და action names.
- შეამოწმეთ TLD-specific registration periods ან contact requirements wაქ applicable.
Paid Operation Does არაt Complete Immediately
- Read the returned
codeდაmsg. - Do not treat a
201pending response as final completion. - დადასტურება account balance და current pricing befანe retrying a paid action.
Need NiceNIC Suppანt
- Recანd the request timestamp და API action.
- Include the დომენი name ან object involved, wაქ applicable.
- Include the returned code და 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 ან pricing request, და verify თქვენი response hდაling befანe turning on customer-facing paid operations.
