ICP备案查询V3

接口说明

DNSpod在线ICP备案查询接口，用于查询指定域名的备案状态、网站可用性及安全检测信息。适用于需要快速了解目标域名备案合规情况及访问状态的用户。

调用地址

/api/dnspod/security

请求方式

GET、POST

鉴权说明

本接口需要密钥鉴权。请在请求 Query 参数中携带 key 字段，值为您的接口调用密钥。

请求参数

参数说明

• domain：传入需查询的域名，仅支持主域名或子域名，无需携带协议前缀（如 http:// 或 https://）。域名需为有效格式，否则接口将返回错误。

成功响应示例

{
  "code": 0,
  "message": "OK",
  "domain": "baidu.com",
  "modules": [
    "website",
    "icp",
    "secure"
  ],
  "timestamp": "2026-08-30T17:08:22+08:00",
  "elapsed_ms": 0,
  "data": {
    "website": {
      "source": "dnspod_tool",
      "if_black": {
        "status": "1"
      },
      "if_beian": {
        "status": "1",
        "info": "京ICP证030173号-1"
      },
      "ping_test": {
        "status": "2"
      },
      "web_status": {
        "status": "1",
        "code": 200
      }
    },
    "secure": {
      "source": "dnspod_tool",
      "port_80": {
        "status": "1",
        "code": 301
      },
      "port_443": {
        "status": "1",
        "code": 301
      },
      "check_domain": "baidu.com"
    },
    "icp": {
      "IcpNumber": "",
      "RequestId": "56853dbb-0412-46f6-8a84-18b5676a56f9"
    },
    "summary": {
      "icp_beian": "网站已备案（备案号: 京ICP证030173号-1）",
      "http_status": "访问正常（状态码 200）",
      "ping": "Ping 无法连通",
      "miit_blacklist": "网站未在工信部黑名单中",
      "port_80": "正常",
      "port_443": "正常（SSL 证书配置正确）"
    }
  },
  "errors": {}
}

响应字段说明

data.website 字段说明

data.secure 字段说明

data.icp 字段说明

data.summary 字段说明

错误响应示例

当请求处理失败时，接口返回统一的错误响应格式：

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

业务错误码说明

调用示例

终端 curl（bash）

# 使用 GET 方式查询域名备案信息
curl -X GET "https://api.example.com/api/dnspod/security?key=your_api_key&domain=baidu.com"

# 使用 POST 方式查询域名备案信息
curl -X POST "https://api.example.com/api/dnspod/security" \
  -d "key=your_api_key" \
  -d "domain=baidu.com"

PHP

## 注意事项

- **密钥安全**：`key` 为接口调用密钥，请妥善保管，切勿在客户端代码、公开仓库或分享给第三方；建议仅在后端服务中调用本接口。
- **参数校验**：`domain` 仅需传入裸域名（如 `baidu.com`），无需添加 `http://` 或 `https://` 前缀，也无需携带 `www.`；非法格式或空值将导致请求失败。
- **HTTPS 调用**：本接口仅支持 HTTPS 协议，请使用 `https://` 发起请求，避免明文传输密钥和查询参数。
- **频率限制**：接口限制为每分钟约 60 次，超出后可能返回限流错误；如遇限流，请降低调用频率或增加重试间隔。
- **返回字段差异**：不同域名的备案状态不同，返回中的 `data.icp.IcpNumber` 可能为空字符串，属正常情况；请以 `data.summary.icp_beian` 或 `data.website.if_beian` 的汇总判断为准。
- **状态码语义**：`if_black`、`if_beian`、`ping_test`、`web_status` 等字段中的 `status` 为数值状态标识，请勿将其误作 HTTP 状态码；HTTP 状态码见各子对象中的 `code` 字段。
- **调用方式**：本接口同时支持 GET 和 POST，推荐使用 POST 并携带 JSON 请求体，避免查询参数过长或日志泄露密钥。