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 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 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.






