NiceNIC ドメインAPI v2 のよくある質問
APIアクセス、サンドボックステスト、認証、価格、ドメイン操作、レスポンス処理、本番環境への統合に関する実践的な回答をご覧いただけます。
はじめに
アクセス、料金、認証情報から始めましょう。
01 NiceNICドメインAPI v2とは何ですか？
NiceNICドメインAPI v2は、NiceNICアカウントを通じてドメイン管理を自動化するためのHTTPSおよびJSONベースのAPIです。
ドメインの利用可能確認、登録、更新、移管、ポートフォリオ照会、ネームサーバーおよび連絡先情報の変更、料金、DNSレコード、子ネームサーバー、アカウント情報、コンプライアンス関連操作など、主要なワークフローをサポートしています。
APIは、NiceNICドメインサービスをWebサイト、ホスティングプラットフォーム、請求システム、社内ツール、その他のアプリケーションに直接接続したい場合に使用します。
02 NiceNICドメインAPI v2は誰が利用できますか？
有効なNiceNICアカウントであれば、誰でもドメインAPI v2を利用できます。APIアクセスは、マーケットアカウントとリセラーアカウントの両方で利用可能です。
APIアクセスを取得するだけのためにリセラーになる必要はありません。料金にはアカウントタイプが依然として影響します。有料のAPI操作には、リクエストを送信するNiceNICアカウントに割り当てられた料金が適用されます。
03 NiceNICドメインAPI v2は無料ですか？
はい、APIアクセス自体は無料です。APIアクセスの有効化やサポート対象のAPIリクエスト送信に個別の料金はかかりません。
ドメイン登録、更新、移管などの有料操作は、アカウントの料金体系と該当するドメイン規則に従って請求されます。
04 APIを使用するにはリセラーアカウントが必要ですか？
いいえ。APIアクセスとリセラー価格は別です。
通常のNiceNICマーケットアカウントでドメインAPI v2を使用できます。リセラー価格やその他のリセラー特典がビジネス規模に役立つ場合にのみ、リセラーアカウントへアップグレードしてください。
05 API v2は以前のNiceNIC APIとどう違いますか？
ドメインAPI v2は、HTTPSリクエスト、JSONレスポンス、ヘッダーベースの認証、そして個々のドメインとアカウントのワークフローに沿って整理されたドキュメントを使用する、現在のNiceNIC API構造を採用しています。
旧版NiceNIC API上に構築された統合を維持している場合は、本番トラフィックを移行する前に、API v2のパラメータとレスポンス処理を確認し、両バージョンが互換性を持つと想定しないでください。
06 API認証情報を取得するにはどうすればよいですか？
NiceNICアカウントにサインインし、API設定を開いてください。API v2リクエストは、認証にNiceNICユーザー名とAPIシークレットを使用します。
サンドボックスと認証
安全に接続し、本番投入前にテストしてください。
07 NiceNIC ドメインAPI v2 は APIサンドボックスを提供していますか？
はい。NiceNIC は、開発者が本番APIに接続する前に連携をテストできるよう、APIサンドボックスを提供しています。
顧客向け本番ドメイン操作を有効にする前に、サンドボックスを使用して認証、リクエスト整形、レスポンス解析、エラー処理、およびアプリケーションのワークフローを検証してください。
08 サンドボックスと本番APIの違いは何ですか？
APIサンドボックスは、開発および統合テストを目的としています。本番APIは、NiceNICアカウントに対する本番ドメイン操作および有料リクエストに使用されます。
顧客向け本番操作を有効にする前に、サンドボックスで認証、リクエスト処理、レスポンス処理、エラーロジックを検証することをお勧めします。
09 API認証はどのように機能しますか？
HTTPS 経由で API リクエストを送信し、Authorization ヘッダーに NiceNIC のユーザー名と APIシークレットを含めてください。
Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/jsonアカウントでIP制限が有効になっている場合、リクエストは許可されたサーバーIPから送信される必要もあります。
10 ドメインAPI v2はどのエンドポイントを使用しますか？
本番APIのベースエンドポイントは次のとおりです：
https://api.nicenic.net/v2/APIアクションは、各エンドポイントに記載されているパラメータ（category や action など）を使用して選択します。特定の操作の必須パラメータと任意パラメータについては、必ずそのエンドポイント専用のドキュメントに従ってください。
11 API v2のレスポンス形式と文字エンコーディングは何ですか？
API v2のレスポンスはJSON形式で、リクエストパラメータはUTF-8を使用します。
{
"code": 0,
"msg": "success",
"data": {}
}アプリケーションは、すべてのHTTPレスポンスがドメイン操作の完了を意味すると想定するのではなく、返された code と msg を確認する必要があります。
ドメイン操作と料金
サポート対象のワークフローと購入行動をご確認ください。
12 NiceNIC ドメインAPI v2 では何ができますか？
現在ドキュメント化されているAPIを使用すると、ドメインの空き状況確認、登録、更新、移管、ポートフォリオ一覧とドメイン詳細、ネームサーバーおよびドメイン連絡先の更新、ドメイン価格、DNSレコード、子ネームサーバー、アカウント情報、不正使用・コンプライアンスの監視など、さまざまなワークフローを自動化できます。
その他のワークフローは、APIナビゲーション内に個別にドキュメント化されています。
13 本番の登録または移管を有効にする前に、何をテストすべきですか？
まず、ドメインの空き状況確認、ドメイン価格、アカウント残高、ドメイン一覧などのリスクの低い読み取り操作から始めてください。
そのうえで、本番の登録、更新、または移管を有効にする前に、認証、レスポンス解析、エラー処理、保留中オーダーの処理を確認してください。
14 ひとつのAPIリクエストで複数のドメインを確認できますか？
はい。ドメインの空き状況確認エンドポイントは、カンマ区切りの複数のドメイン名に対応しています。
example.com,example.net,example.orgすべてのAPI操作が同じ複数ドメイン入力形式に対応しているとは想定しないでください。登録、更新、移管は、それぞれのエンドポイントのドキュメントに従ってください。
15 登録、更新、移管の価格はどのように照会すればよいですか？
ドメイン料金を取得するGet Domain Pricingエンドポイントを使用します。文書に記載されている料金種別はregister、renew、transfer、allです。
登録応答には、照会した登録がプレミアムかどうかを示す is_premium 値が含まれる場合もあります。
API 注文ではアカウントレベルの料金が使用されるため、キャッシュされた料金に無期限に依存するのではなく、有料の顧客注文を送信する前に現在の料金を照会してください。
16 すべてのTLDは1〜10年で登録または更新できますか？
いいえ。APIドキュメントでは、該当するドメイン拡張子について1〜10年までの期間をサポートしていますが、個々のTLDではレジストリの規則が異なる場合があります。
登録期間、更新期間、移転資格、連絡先要件、検証要件は拡張子によって異なる場合があります。アプリケーションは該当するTLDの現在の規則に従う必要があります。
17 ネームサーバー、DNSレコード、子ネームサーバーの違いは何ですか？
ns1.example.com のようなホスト/グルーレコードを作成します。これらは別個の操作であり、互換的に扱うべきではありません。
レスポンスとエラー
成功・保留中・失敗の各状態を正しく処理してください。
18 APIレスポンスコードはどういう意味ですか？
| コード | 意味 |
|---|---|
0 | 成功 |
201 | 保留中 |
400 | パラメータエラー |
401 | 未認証 |
404 | 該当するレコードが見つかりません |
500 | サーバー内部エラー |
APIリクエストの状態を判断する際は、必ず返されたコードとメッセージを使用してください。
19 コード201は何を意味しますか？
レスポンスコード201は、操作が処理のために受け付けられたことを示しますが、必ずしも最終状態に達したことを意味するわけではありません。
20 ドメイン登録でコード201が返されるとどうなりますか？
ドメイン登録の場合、レスポンスコード201は、注文が送信され、最終的なレジストリ処理を待っていることを示します。
最終結果が自社システムで確認されるまで、エンドカスタマーにドメインが有効であると伝えないでください。最新の保留中注文および返金処理のルールについては、登録エンドポイントのドキュメントに従ってください。
21 保留中の移管レスポンスは何を意味しますか？
保留中の移管とは、移管リクエストが処理のために受け付けられたことを意味し、ドメインが NiceNIC への移管を既に完了したという意味ではありません。
移管の完了は、レジストリおよびレジストラの処理と、ドメインの現在の移管ステータスに依存する場合があります。完了が確認されるまで、移管を保留状態に保ってください。
ポートフォリオ、コンプライアンス＆統合
ポートフォリオを管理し、既存システムと連携します。
22 APIを通じてドメインポートフォリオを取得およびフィルタリングできますか？
はい。ドメイン一覧取得APIは、ページネーション、並べ替え、フィルタリングオプションを備えたポートフォリオ取得をサポートしています。
個別ドメインの詳細情報（登録情報、有効期限情報、ネームサーバー、ドメイン連絡先データなど）が必要な場合は、ドメイン詳細取得を使用してください。
23 不正使用・コンプライアンスAPIは何ができますか？
NiceNIC ドメインAPI v2 には、顧客のドメインポートフォリオを管理するプラットフォームおよびリセラー向けの不正使用・コンプライアンスオペレーションが含まれています。
不正使用レポートに関連付けられたドメインを特定し、個々のドメインに関する機械可読なコンプライアンス情報を取得できます。ケースに応じて、レスポンスにはドメインステータス、現在の影響、推奨アクション、保留情報、苦情情報、報告されたURLを含めることができます。
これにより、自社のカスタマーポータルや運用システム内でコンプライアンスステータスを直接表示できます。
24 NiceNIC ドメイン API v2 を WHMCS で使用できますか？
はい。NiceNIC は、請求とプロビジョニングにすでに WHMCS を利用している企業向けに、WHMCS レジストラ統合を提供しています。
独自のアプリケーションやワークフローを構築する場合は、ドメインAPI v2を直接使用してください。既存のWHMCS環境にドメイン操作を統合する場合は、WHMCS統合を使用してください。
開発とサポート
安全に構築し、サポートが必要なときに何を送信すればよいかを把握できます。
25 どのプログラミング言語を使用できますか？
HTTPSリクエストを送信してJSONを解析できるサーバーサイドのプログラミング言語またはランタイムはすべて、ドメインAPI v2と統合できます。
一般的な選択肢としては、PHP、Python、Node.js、Javaなどがあります。API認証情報はサーバーサイドで保持し、APIシークレットをブラウザ側のJavaScriptやダウンロード可能なクライアントコードに絶対に公開しないでください。
26 APIのレート制限はありますか？
APIの安定性とプラットフォームのセキュリティを保護するため、レート制限が適用される場合があります。
本番統合で継続的な高リクエスト量が発生する見込みがある場合は、開始前にNiceNICに連絡してください。想定される利用パターンを確認できます。
27 APIの問題についてサポートに問い合わせる際、何を含めるべきですか？
リクエストのタイムスタンプ、APIカテゴリとアクション、該当する場合はドメイン名、機密情報を含まないリクエストパラメータ、返されたレスポンスコードとメッセージ、およびリクエストがサンドボックスと本番環境のどちらから送信されたかを含めてください。
28 完全なリクエストパラメータとコード例はどこで確認できますか？
ドキュメントのAPIナビゲーションを使用してください。各操作には、サポートされているパラメータ、リクエスト例、レスポンス例、操作固有の動作に関する専用ページがあります。
FAQではAPIの一般的な動作について説明しています。正確なリクエスト形式については、各エンドポイントのドキュメントを正式な情報源としてください。
構築を始める準備はお済みですか？
APIサンドボックスで統合をテストし、本番環境に移行する準備ができたらNiceNICアカウントを接続してください。
大量のドメインにはリセラー価格が必要ですか？
リセラープランを比較する →
