NiceNIC დომენი API v2 Documentation & Quick Start
NiceNIC დომენი API v2 is ხელმისაწვდომია to both საბაზრო ანგარიშიs და რეზელერი ანგარიშიs. 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.
რეზელერი ანგარიში: 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.
დადასტურება ავტორიზაცია
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 ქმედებაs.
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 |
|---|---|---|
| መწყობა | Connect securely და understდა response hდაling. | API მიმოხილვა, API Sდაbox, ავტორიზაცია, Response Codes. |
| დომენის მართვა | Automate the cანe დომენი lifecycle. | Availability, სიაში დომენები, დომენი დეტალები, რეგისტრაცია, განახლებაal, გადარიცხვა In, სახელიservers, კონტაქტიs, Pricing. |
| ზეწოლა და შესაბამისობა | Monitან დომენიs that require compliance attention. | სიაში დომენიs with abuse repანts და retrieve machine-readable abuse status, hold lifecycle, complaint infანmation და recommended ქმედება. |
| DNS ჩანაწერები | მართვა hosted DNS recანds programmatically. | სიაში, შექმნა, განახლება და წაშლა DNS recანds. |
| ბავშვის სერვერული სახელები | მართვა host / glue recანds fან nameservers under თქვენი own დომენი. | შექმნა, სიაში, განახლება და წაშლა child nameservers. |
| ანგარიში და გადახდა | Connect automation to account-level checks. | ანგარიშის ბალანსი და transქმედება-related account infანmation. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wანkflow. | Availability, რეგისტრაცია, განახლებაal, გადარიცხვა, დომენი დეტალები, სახელი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 ქმედებაs
Process code + მომართვა
რეგისტრაცია / განახლება / გადარიცხვა
Understდა წარმატება, მოლოდინი და Errან Responses
code: 0 — წარმატებით შესრულდა Response
Current endpoint examples use code 0 fან successful completed responses.
code: 201 — მოლოდინი 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 შეცდომაs.
რეგისტრაცია მოლოდინი 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.
გადარიცხვა მოლოდინი 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 ჩანაწერები და ბავშვის სერვერული სახელები
| Operation | Use It When | Documented Capability |
|---|---|---|
| დაამატე სახელწოდების სერვერები | 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 ჩანაწერები | You are using NiceNIC DNS hosting და need to manage zone recანds. | Separate APIs are documented fან listing, creating, updating და deleting DNS recანds. |
| ბავშვის სერვერული სახელები | 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 სიაში დომენები endpoint suppანts pagination, sანting, status filtering და hold filtering, while მიიღეთ დომენი დეტალები returns registration dates, expiration dates, nameservers და registrant contact infანmation.
ზეწოლა და შესაბამისობა Monitანing
NiceNIC's ზეწოლა და შესაბამისობა 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, მოლოდინი ClientHold, ClientHold, დახურვაd და სერვერიHold.
The response can include current impact, recommended შემდეგი ქმედება, 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, შეცდომა logging და optional Test Mode. |
The current WHMCS documentation lists WHMCS 7.0 ან უფრო ახალი ვერსია, 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 ქმედება repeatedly.
ავტორიზაცია ან 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 და ქმედება 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 ქმედება.
Need NiceNIC Suppანt
- Recანd the request timestamp და API ქმედება.
- 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.






