アカウント管理

アカウント管理カテゴリでは、Domain Name API リセラーアカウント（dm.apiname.com）のデポジット（Deposit）入金、残高（Balance）管理、API アクセスの設定を解説します。デポジットは銀行振込（EFT）で入金でき、振込時に摘要欄へアカウント専用の参照番号だけを入力すると、自動的にアカウントと照合されます。デポジットは送金した通貨（TRY または USD）のまま反映され、両替は行われません。

REST API 連携に必要な API Key と Reseller ID（GUID）は、リセラーパネルの API 設定で確認できます。テスト環境（OT&E）には別のテスト用 API キーが発行され、残高は差し引かれません。キーが漏えいした疑いがある場合は、すぐにパネルで再生成（Regenerate）してください。古いキーはその時点で使えなくなります。

現在の TRY、USD 残高は GET /api/v1/deposit/accounts/me、残高の入出金履歴は GET /api/v1/deposit/transactions エンドポイントで取得できます。アカウントの安全のため、二要素認証（2FA）と API アクセス用の IP ホワイトリスト（IP Whitelist）を併用することをおすすめします。関連する英語の API ドキュメント：Authentication · Balance

一括処理の途中で残高が不足すると Deposit:10001 エラーが続けて発生するため、レスポンスの tryBalance と usdBalance の値で残高不足の通知を作っておくと安心です。すべてのリクエストには X-API-KEY と __reseller の 2 つの認証ヘッダーが必要で、X-Correlation-ID ヘッダーを付けるとサポートチケットで該当リクエストをすぐに見つけられます。サブリセラー（Sub-reseller）アカウントは REST API を直接利用できず、上位のリセラーが代わりに呼び出す必要があります。 残高のレスポンスにはアカウントの価格グループ（resellerGroupName、例：Standard）も含まれるため、TLD と SSL の価格一覧ではこの値と同じ priceGroup の項目を使用してください。