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 البرمجية 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 البرمجية, 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 رموز استجابة واجهة برمجة التطبيقات →

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 List النطاقات 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 →