domains

Hostinger 域名

Domains API 提供完整的域名生命周期管理——从检查可用性和购买，到配置名称服务器、转发、WHOIS 配置文件、域名锁定和隐私保护。

目录

• 核心概念
• 常见模式
• API 参考
• 最佳实践
• 故障排除
• 参考

核心概念

域名组合

你的域名组合包含在你的 Hostinger 账户下注册的所有域名。每个域名都有名称服务器、WHOIS 联系人、锁定状态和隐私保护的配置。

域名可用性

在购买之前，检查一个域名是否在一个或多个 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,
]);

注意： 速率限制为每分钟 10 个请求。TLD 不应带前导点（例如，com 而不是 .com）。对于替代项，只提供一个 TLD。

购买域名

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 个名称服务器
• 切换前验证名称服务器是否响应

转发

• 使用 301（永久）进行保留 SEO 的重定向
• 使用 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 工具