এপিআই ধারণা
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 Headers
হোস্ট: api.nicenic.net
অনুমোদন: username:api_secret
Content-Type: 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 "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 + বার্তা
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, ডিএনএস রেকর্ডস এবং চাইল্ড নেমসার্ভারস
| 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
