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 with マーケットアカウント pricing.
リセラー アカウント: 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.
確認 認証
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 アクションs.
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 |
|---|---|---|
| 始めに | Connect securely と understと response hとling. | API概要, 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 アクション. |
| DNSレコード | 管理 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. |
| WHMCS API | Integrate NiceNIC into an existing WHMCS billing wまたはkflow. | Availability, 登録, 更新al, 移管, ドメイン 詳細, 名前servers, お問い合わせs と additional registrar-module functions. |
| API FAQ | 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 アクションs
Process code + msg
登録 / 更新 / 移管
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.
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レコード と 子ネームサーバー
| 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. |
| DNSレコード | 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. |
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.
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.
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.






