domains

Hostinger Domains

Domains API は、利用可能状況の確認や購入から、ネームサーバー、転送、WHOIS プロファイル、ドメインロック、プライバシー保護の設定まで、ドメインのライフサイクル全体を管理できます。

目次

• 基本概念
• 一般的なパターン
• API リファレンス
• ベストプラクティス
• トラブルシューティング
• 参考資料

基本概念

ドメインポートフォリオ

ドメインポートフォリオには、Hostinger アカウントで登録されているすべてのドメインが含まれます。各ドメインには、ネームサーバー、WHOIS 連絡先、ロック状態、プライバシー保護の設定があります。

ドメインの利用可能状況

購入する前に、1 つ以上の TLD でドメイン名が利用可能か確認できます。API は代替ドメインの候補も提供します。

ドメイン転送

301（恒久的）または 302（一時的）リダイレクトを使用して、ドメインを別の URL に転送します。

WHOIS プロファイル

ドメイン登録に関連付けられた連絡先情報です。TLD ごとに固有の WHOIS 情報が必要な場合があります。プロファイルは複数のドメインで再利用できます。

ドメインロック

不正なドメイン移管を防ぎます。ドメインを別のレジストラーに移管する前に無効にする必要があります。

プライバシー保護

ドメイン所有者の個人情報が公開 WHOIS データベースに表示されないようにします。

ドメインアクセスの確認

一部の操作では、ドメインを管理していることの証明が必要です。Domain Access Verifier は、指定したドメインの保留中および完了済みの確認情報を返すため、ドメインを利用する前に確認状況を調べられます。

注： このエンドポイントは別のベースパス /api/v2/direct/verifications/active にあり、/api/domains/v1/ ではありません。

一般的なパターン

ドメインの利用可能状況を確認する

curl -X POST "https://developers.hostinger.com/api/domains/v1/availability" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "myawesomesite",
    "tlds": ["com", "net", "org"],
    "with_alternatives": true
  }'

Python SDK：

from hostinger_api import Hostinger

client = Hostinger(api_token="YOUR_API_TOKEN")
result = client.domains.availability.check(
    domain="myawesomesite",
    tlds=["com", "net", "org"],
    with_alternatives=True
)

TypeScript SDK：

import { Hostinger } from "hostinger-api-sdk";

const client = new Hostinger({ apiToken: "YOUR_API_TOKEN" });

const result = await client.domains.availability.check({
  domain: "myawesomesite",
  tlds: ["com", "net", "org"],
  withAlternatives: true,
});

PHP SDK：

use Hostinger\Api\HostingerApi;

$client = new HostingerApi('YOUR_API_TOKEN');

$result = $client->domains->availability->check([
    'domain' => 'myawesomesite',
    'tlds' => ['com', 'net', 'org'],
    'with_alternatives' => true,
]);

注： レート制限は 1 分あたり 10 件です。TLD の先頭にドットを付けないでください（例：.com ではなく com）。代替候補を取得する場合は、TLD を 1 つだけ指定してください。

ドメインを購入する

curl -X POST "https://developers.hostinger.com/api/domains/v1/portfolio" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "my-new-domain.com",
    "item_id": "hostingercom-domain-com-usd-1y",
    "payment_method_id": 1327362,
    "domain_contacts": {
      "owner_id": 741288,
      "admin_id": 741288,
      "billing_id": 741288,
      "tech_id": 741288
    }
  }'

item_id は請求カタログから取得してください。支払い方法を指定しない場合は、デフォルトの支払い方法が使用されます。WHOIS 情報を指定しない場合は、その TLD のデフォルトの連絡先情報が使用されます。

ドメインの一覧表示と詳細確認

# List all domains
curl -X GET "https://developers.hostinger.com/api/domains/v1/portfolio" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Get domain details
curl -X GET "https://developers.hostinger.com/api/domains/v1/portfolio/example.com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

ネームサーバーを設定する

curl -X PUT "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/nameservers" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ns1": "ns1.custom-dns.com",
    "ns2": "ns2.custom-dns.com"
  }'

ドメイン転送

# Create forwarding (301 permanent redirect)
curl -X POST "https://developers.hostinger.com/api/domains/v1/forwarding" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "old-domain.com",
    "redirect_type": "301",
    "redirect_url": "https://new-domain.com"
  }'

# Get forwarding config
curl -X GET "https://developers.hostinger.com/api/domains/v1/forwarding/old-domain.com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Delete forwarding
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/forwarding/old-domain.com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

ドメインロックとプライバシー保護

# Enable domain lock (prevent transfers)
curl -X PUT "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/domain-lock" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Disable domain lock (before transfer)
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/domain-lock" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Enable privacy protection
curl -X PUT "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/privacy-protection" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Disable privacy protection
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/portfolio/example.com/privacy-protection" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

WHOIS プロファイルの管理

# List WHOIS profiles (optionally filter by TLD)
curl -X GET "https://developers.hostinger.com/api/domains/v1/whois?tld=com" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Create a WHOIS profile
curl -X POST "https://developers.hostinger.com/api/domains/v1/whois" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tld": "com",
    "entity_type": "individual",
    "country": "US",
    "whois_details": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone": "+1.5551234567",
      "address": "123 Main St",
      "city": "New York",
      "state": "NY",
      "zip": "10001"
    }
  }'

# Check which domains use a WHOIS profile
curl -X GET "https://developers.hostinger.com/api/domains/v1/whois/741288/usage" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Delete a WHOIS profile
curl -X DELETE "https://developers.hostinger.com/api/domains/v1/whois/741288" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

ドメインの確認状況を調べる

# Get pending and completed verifications for one or more domains
curl -X GET "https://developers.hostinger.com/api/v2/direct/verifications/active" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "domains": ["example.com", "example.net"] }'

API リファレンス

利用可能状況

メソッド	エンドポイント	説明
POST	/api/domains/v1/availability	ドメインの利用可能状況を確認（レート制限：10 件/分）

ポートフォリオ

メソッド	エンドポイント	説明
GET	/api/domains/v1/portfolio	すべてのドメインを一覧表示
POST	/api/domains/v1/portfolio	新しいドメインを購入
GET	/api/domains/v1/portfolio/{domain}	ドメインの詳細を取得
PUT	/api/domains/v1/portfolio/{domain}/nameservers	ネームサーバーを更新
PUT	/api/domains/v1/portfolio/{domain}/domain-lock	ドメインロックを有効化
DELETE	/api/domains/v1/portfolio/{domain}/domain-lock	ドメインロックを無効化
PUT	/api/domains/v1/portfolio/{domain}/privacy-protection	プライバシー保護を有効化
DELETE	/api/domains/v1/portfolio/{domain}/privacy-protection	プライバシー保護を無効化

転送

メソッド	エンドポイント	説明
POST	/api/domains/v1/forwarding	ドメイン転送を作成
GET	/api/domains/v1/forwarding/{domain}	転送設定を取得
DELETE	/api/domains/v1/forwarding/{domain}	転送を削除

WHOIS

メソッド	エンドポイント	説明
GET	/api/domains/v1/whois	WHOIS プロファイルの一覧を取得
POST	/api/domains/v1/whois	WHOIS プロファイルを作成
GET	/api/domains/v1/whois/{whoisId}	WHOIS プロファイルを取得
DELETE	/api/domains/v1/whois/{whoisId}	WHOIS プロファイルを削除
GET	/api/domains/v1/whois/{whoisId}/usage	プロファイルの使用状況を取得

検証

メソッド	エンドポイント	説明
GET	/api/v2/direct/verifications/active	保留中および完了済みのドメイン検証を取得（本文：domains 文字列配列）

ベストプラクティス

登録

• 購入を試みる前に、必ず利用可能かどうかを確認してください
• 登録前に、対象の TLD 用の WHOIS プロファイルが存在することを確認してください
• 一部の TLD では additional_details が必要です。TLD ごとの要件を確認してください
• 不正な移管を防ぐため、ドメインロックを有効にしてください

セキュリティ

• プライバシー保護を有効にして、公開 WHOIS から個人情報を非表示にしてください
• 本番環境のすべてのドメインでドメインロックを有効にしてください
• 移管を行う直前に限り、ドメインロックを無効にしてください

ネームサーバー

• ネームサーバーの設定が正しくないと、ドメインを解決できなくなります
• 常に少なくとも 2 つのネームサーバーを設定してください
• 切り替える前に、ネームサーバーが応答していることを確認してください

転送

• SEO を維持するリダイレクトには 301（恒久的）を使用してください
• 短期間のリダイレクトには 302（一時的）を使用してください
• ドメインをホスティングに向ける前に、転送設定を削除してください

トラブルシューティング

ネームサーバー変更後にドメインを解決できない

• ネームサーバーの変更が反映されるまで、最大 48 時間かかることがあります
• 新しいネームサーバーが正しく設定されていることを確認してください：dig NS example.com
• 新しいネームサーバーに DNS レコードが存在することを確認してください

ドメインの購入に失敗した

• hPanel で登録状況を確認してください
• 対象の TLD 用の WHOIS プロファイルが完成していることを確認してください
• 支払い方法に十分な残高があることを確認してください

ドメインロックを無効にできない

• 一部の TLD では、登録後にレジストラが定めたロック期間があります
• ロック状態が変わらない場合は、サポートにお問い合わせください

WHOIS プロファイルの削除に失敗する

• プロファイルが使用中のドメインに使われている可能性があります
• まず /whois/{whoisId}/usage エンドポイントで使用状況を確認してください

関連項目

このスキルディレクトリでは、以下の詳細ガイドを利用できます。

• transfer-guide.md — ドメイン購入のワークフロー、ネームサーバーの設定、移管手順、WHOIS の管理、一括操作（TypeScript／PHP の例）

参考資料

• Hostinger API ドキュメント
• Hostinger API 変更履歴
• Python SDK
• TypeScript SDK
• PHP SDK
• CLI ツール