域名综合信息查询

接口说明

提供域名综合信息查询服务，集合 Whois 注册信息、DNS 解析检测与 ICP 备案查询能力，适用于需要快速了解域名注册状态、解析记录及备案情况的调用场景。该接口免费开放，调用时需携带密钥进行身份验证。

调用地址

GET /api/dnspod/index

请求方式

支持 GET 请求方式。

鉴权说明

本接口需要密钥认证。请在请求的查询参数中携带您的接口调用密钥：

• key（必填）：您的接口调用密钥，通过 Query 方式传递，例如 ?key=your_api_key。

请求参数

成功响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "domain": "example.com",
        "whois": {
            "registrar": "Example Registrar, Inc.",
            "creation_date": "2000-01-01",
            "expiration_date": "2030-01-01",
            "updated_date": "2024-06-01",
            "status": "clientTransferProhibited",
            "name_servers": [
                "ns1.example.com",
                "ns2.example.com"
            ]
        },
        "dns": {
            "a": ["93.184.216.34"],
            "aaaa": ["2606:2800:220:1:248:1893:25c8:1946"],
            "mx": [
                {
                    "host": "mx.example.com",
                    "priority": 10
                }
            ],
            "cname": null,
            "txt": ["v=spf1 include:_spf.example.com ~all"],
            "ns": ["ns1.example.com", "ns2.example.com"],
            "soa": {
                "primary_ns": "ns1.example.com",
                "hostmaster": "hostmaster.example.com",
                "serial": 2024010101
            }
        },
        "icp": {
            "status": "active",
            "company_name": "示例科技有限公司",
            "license_number": "京ICP备00000000号",
            "site_name": "示例网站",
            "domain": "example.com",
            "approved_date": "2023-05-12"
        },
        "cache": false,
        "query_time": "2025-01-20T10:30:00+08:00"
    }
}

响应字段说明

顶层字段

data 对象

whois 对象

dns 对象

icp 对象

错误响应示例

当接口调用发生业务异常时，返回 HTTP 200 状态码，响应体为以下 JSON 结构：

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

其中 msg 字段为人类可读的错误描述，errcode 为业务错误码，用于程序化判断具体错误类型。

业务错误码说明

调用示例

终端 curl（bash）

# 查询域名 example.com 的综合信息
curl -X GET "https://api.example.com/api/dnspod/index?key=YOUR_API_KEY&domain=example.com"

# 强制刷新缓存后重新查询
curl -X POST "https://api.example.com/api/dnspod/index" \
  -d "key=YOUR_API_KEY" \
  -d "domain=example.com" \
  -d "refresh=1"

PHP

注意事项

• 本接口通过 HTTPS + Query 方式传递密钥，请务必在服务端调用，切勿将密钥写入前端页面、App 包或公开代码仓库，防止泄露。
• 接口频率限制约为每分钟 60 次，超过限制可能返回失败或临时封禁，请根据自身业务合理控制调用间隔。
• domain 仅需传入标准域名（如 example.com），不要携带 http://、https://、路径或端口等附加内容。
• module、raw、health 等参数仅在明确需要对应数据时使用，日常查询请保持默认，避免产生非预期开销。
• refresh 用于强制跳过缓存、发起新的实时查询，该操作可能明显增加响应耗时，请仅在数据确需更新时使用。
• 本接口为免费服务，不保证返回速度，若遇瞬时超时可稍后重试，避免高频连续请求加重服务压力。