API Ուղեցույց
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 և reseller pricing are separate.
Շուկայական հաշիվ: API access with Շուկայական հաշիվ pricing.
Վաճառող Հաշիվ: API access with the pricing assigned to the current reseller tier.
Շուկայական հաշիվ: API access with Շուկայական հաշիվ pricing.
Վաճառող Հաշիվ: API access with the pricing assigned to the current reseller tier.
Base Endpoint
https://api.nicenic.net/v2/
Required Հեդերs
Հոստ՝ api.nicenic.net
Վավերացման տվյալներ՝ username:api_secret
Բովանդակության տիպ՝ application/json
Stևard Հաջողություն Response
{
"code": 0,
"հաղորդագրություն": "success",
"data": {}
}
API Sևbox
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.
Quick Start
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.
1
Enable API Access
Բաց API Կարգավորումներs, create կամ retrieve քո API Secret, և configure authկամized server IPs wայստեղ applicable.
2
Հաստատել Հաստատում
Use HTTPS with the Authկամization header in the fկամmat username:api_secret.
3
Run a Safe Test
Start with դոմեյն availability, pricing, account balance կամ դոմեյն listing.
4
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.
curl "https://api.nicenic.net/v2/?կատեգորիա=դոմեյն&գործողություն=check&դոմեյնs=example.com,example.net" \
-H "Վավերացման տվյալներ՝ username:api_secret" \
-H "Բովանդակության տիպ՝ application/json"
API Map
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 Wկամkflow
Recommended First Ինտեգրացիա Sequence
A reliable production integration should validate access և purchasing conditions befկամe it begins sending live customer կամders.
1. Հաստատում
API Secret + authկամized IP
API Secret + authկամized IP
→
2. Availability
Read-only connectivity test
Read-only connectivity test
→
3. Pricing
Query current account-level cost
Query current account-level cost
→
4. Մնացորդ
Հաստատել funds fկամ paid գործողությունs
Հաստատել funds fկամ paid գործողությունs
→
5. Response Hևling
Process code + հաղորդագրություն
Process code + հաղորդագրություն
→
6. Live Operations
Գրանցում / Վերանորոգում / Փոխանցում
Գրանցում / Վերանորոգում / Փոխանցում
Do not assume that an API request is complete simply because it was accepted. Some operations can return a pending status և still require registry processing befկամe the final դոմեյն state is confirmed.
Ապրանքion Behaviկամ
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.
Pricing
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.
Անվճար API access does not change քո pricing tier. Շուկայական հաշիվs use Շուկայական հաշիվ pricing; reseller accounts use the pricing assigned to their current reseller tier.
Դոմեն & DNS Operations
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. |
Pկամtfolio & Compliance
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.
Direct API կամ WHMCS
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.
Troubleshooting
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.
Last verified: August 26, 2026
