API 接入指南

基本信息

• 基础地址：https://dreamname.net
• 数据格式：JSON
• 字符编码：UTF-8
• 限速：每分钟 60 次请求

认证方式

所有 API 请求需在 Header 中携带 API Token：

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

获取 API Token

登录后前往「用户中心」→「API 密钥」标签页，点击「生成 API 密钥」按钮即可获取。

公开接口（无需认证）

需认证接口

请求示例

WHOIS 查询

curl "https://dreamname.net/api/whois?domain=example.com"

返回：

{
  "ok": true,
  "registered": true,
  "domain_ascii": "example.com",
  "overview": {
    "registrar": "RESERVED-Internet Assigned Numbers Authority",
    "created": "1995-08-14",
    "expires": "2025-08-13",
    "ns": ["a.iana-servers.net", "b.iana-servers.net"]
  }
}

DNS 查询

curl "https://dreamname.net/api/dns?domain=example.com&type=A"

TLD 价格查询

curl "https://dreamname.net/api/tld-price?tld=com"

错误处理

所有接口在出错时返回 {"ok": false, "error": "错误描述"}，HTTP 状态码为 4xx 或 5xx。