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.
