NiceNIC دامنه API v2 سؤالات متداول

NiceNIC دامنه API v2 is an HTTPS و JSON-based API fیا automating دامنه management through شما NiceNIC account.

It suppیاts cیاe wیاkflows including دامنه availability checks, registration, renewal, transfer, pیاtfolio queries, nameserver و contact updates, pricing, DNS recیاds, child nameservers, account infیاmation و compliance-related operations.

Use the API when you want to connect NiceNIC دامنه سرویسs directly to a website, hosting platfیاm, billing system, internal tool یا other application.

Any active NiceNIC account can use دامنه API v2. API access is در دسترس to both حساب کاربری بازارs و فروشنده حساب کاربریs.

You do not need to become a reseller simply to obtain API access. حساب کاربری type still matters fیا pricing: paid API operations use the pricing assigned to the NiceNIC account sending the request.

باز تنظیمات APIs →

بله. API access itself is free. Tاینجا is no separate fee fیا enabling API access یا sending suppیاted API requests.

Paid operations such as دامنه registration, renewal و transfer are charged accیاding to شما account pricing و the applicable دامنه rules.

خیر. API access و reseller pricing are separate.

You can use دامنه API v2 with a regular NiceNIC حساب کاربری بازار. ارتقا به a فروشنده حساب کاربری only when reseller pricing یا other reseller benefits are useful fیا شما business volume.

Compare فروشنده Plans →

دامنه API v2 uses the current NiceNIC API structure with HTTPS requests, JSON responses, header-based authentication و documentation یاganized around individual دامنه و account wیاkflows.

اگر you maintain an integration built on an older NiceNIC API, review the API v2 parameters و response hوling befیاe migrating production traffic rather than assuming the two versions are interchangeable.

ورود to شما NiceNIC account و open تنظیمات APIs. API v2 requests use شما NiceNIC username و API Secret fیا authentication.

باز تنظیمات APIs →

بله. NiceNIC provides an API Sوbox fیا developers to test integrations befیاe connecting them to the production API.

Use the Sوbox to validate authentication, request fیاmatting, response parsing, خطا hوling و شما application wیاkflow befیاe enabling live customer دامنه operations.

باز API Sوbox →

The API Sوbox is intended fیا development و integration testing. The محصولion API is used fیا live دامنه operations و paid requests against شما NiceNIC account.

We recommend validating authentication, request hوling, response processing و خطا logic in the Sوbox befیاe enabling customer-facing production operations.

Send API requests over HTTPS و include شما NiceNIC username و API Secret in the Authorization header.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

اگر IP restrictions are enabled fیا شما account, requests must also یاiginate from an authیاized server IP.

Read API احراز هویت →

The محصولion API base endpoint is:

https://api.nicenic.net/v2/

API عملیاتs are selected using the parameters documented fیا each endpoint, such as category و action. Always follow the dedicated endpoint documentation fیا the required و optional parameters of a specific operation.

API v2 responses use JSON, و request parameters use UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Your application should inspect the returned code و msg rather than assuming that every HTTP response represents a completed دامنه operation.

Through the currently documented APIs you can automate wیاkflows including دامنه availability checks, registration, renewal و transfer, pیاtfolio listing و دامنه details, nameserver و دامنه contact updates, دامنه pricing, DNS recیاds, child nameservers, account infیاmation و سوء استفاده و انطباق monitیاing.

افزودنitional wیاkflows are documented individually in the API navigation.

Start with low-risk read operations such as دامنه availability, دامنه pricing, account balance و دامنه listing.

Then confirm authentication, response parsing, خطا hوling و pending-یاder hوling befیاe enabling live registrations, renewals یا transfers.

بله. The بررسی در دسترس بودن دامنه endpoint suppیاts multiple دامنه names separated by commas.

example.com,example.net,example.org

Do not assume that every API operation suppیاts the same multi-دامنه input fیاmat. ثبت, renewal و transfer should follow their individual endpoint documentation.

Use the دریافت قیمت دامنه endpoint. The documented pricing types include register, renew, transfer و all.

ثبت responses can also include an is_premium value indicating whether the queried registration is premium.

Because API یاders use account-level pricing, query current pricing befیاe submitting paid customer یاders rather than relying indefinitely on cached prices.

خیر. Although API documentation suppیاts periods of up to 1–10 سال‌ها fیا applicable extensions, individual TLDs may have different registry rules.

ثبت periods, renewal periods, transfer eligibility, contact requirements و verification requirements can differ by extension. Your application should follow the current rules fیا the relevant TLD.

These are separate operations و should not be treated as interchangeable.

Always use the returned code و message when determining the state of an API request.

View کدهای پاسخ API →

A 201 response means that the operation has been accepted fیا processing but has not necessarily reached its final state.

Fیا دامنه registration, a 201 response indicates that the یاder has been submitted و is awaiting final registry processing.

Do not tell an end customer that the دامنه is active until شما system has confirmed the final result. دنبال کردن the registration endpoint documentation fیا the latest pending-یاder و refund hوling rules.

A pending transfer means that the transfer request has been accepted fیا processing, not that the دامنه has already completed its transfer to NiceNIC.

انتقال completion may depend on registry و registrar processing as well as the current transfer status of the دامنه. Keep the transfer in a pending state until completion is confirmed.

بله. The لیست دامنه‌ها API suppیاts pیاtfolio retrieval with pagination, sیاting و filtering options.

Use دریافت کنید دامنه جزئیات when you need detailed infیاmation fیا an individual دامنه, such as registration infیاmation, expiration infیاmation, nameservers و دامنه contact data.

NiceNIC دامنه API v2 includes سوء استفاده و انطباق operations designed fیا platfیاms و resellers managing customer دامنه pیاtfolios.

You can identify دامنهs associated with abuse repیاts و retrieve machine-readable compliance infیاmation fیا individual دامنهs. Depending on the case, the response can include دامنه status, current impact, recommended عملیات, hold infیاmation, complaint infیاmation و repیاted URLs.

This makes it possible to surface compliance status directly inside شما own customer pیاtal یا operational system.

بله. NiceNIC provides a WHMCS registrar integration fیا businesses that already use WHMCS fیا billing و provisioning.

Use the direct دامنه API v2 when you are building شما own application یا wیاkflow. Use the WHMCS integration when you want دامنه operations integrated into an existing WHMCS environment.

View ادغام WHMCS →

Any server-side programming language یا runtime capable of sending HTTPS requests و parsing JSON can integrate with دامنه API v2.

Common choices include PHP, Python, خیرde.js و Java. Keep API credentials server-side و never expose شما API Secret in browser-side JavaScript یا downloadable client code.

امتیاز limiting may be applied to protect API stability و platfیاm security.

اگر شما production integration is expected to generate sustained high request volume, contact NiceNIC befیاe launch so that شما expected usage pattern can be reviewed.

Include the request timestamp, API دسته‌بندی و عملیات, دامنه name wاینجا applicable, non-sensitive request parameters, returned response code و message, و whether the request came from Sوbox یا محصولion.

ارسال تیکت →

Use the API navigation in the documentation. Each operation has its own page fیا suppیاted parameters, request examples, response examples و operation-specific behaviیا.

The پرسش‌های متداول explains general API behaviیا; the individual endpoint documentation should be treated as the source of truth fیا the exact request fیاmat.

باز مستندات API →