ای پی آئی کا جائزہ
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
Content-Type: application/json
Stاورard کامیاب Response
{
"code": 0,
"msg": "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 "Content-Type: 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 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 عمل. |
| ڈی این ایس ریکارڈز | منظم کریں 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. |
| ڈبلیو ایچ ایم سی ایس اے پی آئی | 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 + msg
Process code + msg
→
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, ڈی این ایس ریکارڈز اور چائلڈ نیم سرورز
| 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. |
| ڈی این ایس ریکارڈز | 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
