API Overview

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 と reseller pricing are separate.
マーケットアカウント: API access with マーケットアカウント pricing.
リセラー Account: API access with the pricing assigned to the current reseller tier.
Base Endpoint
https://api.nicenic.net/v2/
Required Headers
Host: api.nicenic.net Authまたはization: username:api_secret Content-種類: application/json
Stとard Success Response
{ "code": 0, "msg": "success", "data": {} }
API Sとbox

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.

Quick Start

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.

1

Enable API Access

開く API設定s, create または retrieve あなたの API Secret, と configure authまたはized server IPs wこちら applicable.

2

確認 Authentication

Use HTTPS with the Authまたはization header in the fまたはmat username:api_secret.

3

Run a Safe Test

Start with ドメイン availability, pricing, account balance または ドメイン listing.

4

Hとle the Response

Read と stまたはe the returned codemsg 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.

curl "https://api.nicenic.net/v2/?categまたはy=ドメイン&action=check&ドメインs=example.com,example.net" \ -H "Authまたはization: username:api_secret" \ -H "Content-種類: application/json"
API Map

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 Wまたはkflow

Recommended First 統合 Sequence

A reliable production integration should validate access と purchasing conditions befまたはe it begins sending live customer またはders.

1. Authentication
API Secret + authまたはized IP
2. Availability
Read-only connectivity test
3. Pricing
Query current account-level cost
4. 残高
確認 funds fまたは paid actions
5. Response Hとling
Process code + msg
6. Live Operations
登録 / 更新 / Transfer
Do not assume that an API request is complete simply because it was accepted. Some operations can return a pending status と still require registry processing befまたはe the final ドメイン state is confirmed.
商品ion Behaviまたは

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.

Pricing

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

無料 API access does not change あなたの pricing tier. マーケットアカウントs use マーケットアカウント pricing; reseller accounts use the pricing assigned to their current reseller tier.
ドメイン & DNS Operations

K今すぐ the Difference Between 名前servers, DNS Recまたはds と Child 名前servers

OperationUse It WhenDocumented 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.
Pまたはtfolio & Compliance

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.

Direct API または WHMCS

Choose the 統合 Model That Fits Your System

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

Troubleshooting

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 codemsg.
  • Do not treat a 201 pending 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.

Last verified: August 26, 2026
著作権 © 2006–2026 NICENIC INTERNATIONAL GROUP CO., LIMITED. 無断転載を禁じます. · U.S. Affiliate: NICENIC LLC