close
批量域名查询 API

一个提交接口,四种固定批量查询

公开 API 保持简单:WHOIS、ICP备案、微信拦截、域名被墙。提交任务后拿 job_id,再查询进度和结果;网页里的复杂分析、自定义工作流和内部工具接口不作为公开 API 契约。

POST /v1/batch-query
{
  "type": "whois",
  "domains": [
    "example.com",
    "example.cn"
  ],
  "locale": "zh"
}

→ {
  "contract_version": "batch-query-v1",
  "job_id": "...",
  "type": "whois",
  "status": "queued",
  "total": 2
}
01

POST /v1/batch-query

提交一批域名。每次任务只选择一种固定查询类型,减少契约复杂度。

02

GET /v1/batch-query/{job_id}

读取任务状态、完成数、失败数以及每个域名已经生成的标准化结果。

03

Authorization

Bearer odi_live_…
API 权限跟随会员套餐和后台套餐配置。

04

Idempotency-Key

提交批量任务必须带稳定的 Idempotency-Key。相同请求重试不会重复创建任务或重复结算。

当前开放能力

第一版只开放四项

后端仍保留其他能力,但不再把内部模块和复杂工作流当成公开 API 契约。

01

whois

WHOIS / 注册信息

02

icp

ICP备案

03

wechat

微信拦截

04

wall

域名被墙

提交任务

请求格式固定

curl -X POST https://aiyucha.com/v1/batch-query \
  -H "Authorization: Bearer odi_live_..." \
  -H "Idempotency-Key: batch-20261001-001" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "icp",
    "domains": ["example.cn", "example.com"],
    "locale": "zh"
  }'
读取结果

任务结束前也可以持续读取进度

GET /v1/batch-query/{job_id}

→ {
  "contract_version": "batch-query-v1",
  "job_id": "...",
  "type": "icp",
  "status": "running",
  "total": 100,
  "completed": 37,
  "failed": 1,
  "progress_percent": 38.0,
  "items": [
    {
      "domain": "example.cn",
      "status": "completed",
      "result": { ... },
      "error": null
    }
  ]
}

公开 API 契约边界

对外只承诺上面两个批量接口和四种 type。旧的单项工具、工作流、内部兼容路由继续服务现有产品,但不属于新的公开 API 文档与稳定契约。

契约版本batch-query-v1
提交POST /v1/batch-query
结果GET /v1/batch-query/{job_id}
执行方式后台任务队列;无需保持长连接
API 常见问题

批量查询、鉴权与计费

API 目前开放哪些查询?

第一版只开放四项固定批量查询:WHOIS、ICP备案、微信拦截和域名被墙检测。网页中的其他分析能力暂不作为公开 API 提供。

批量任务需要一直保持 HTTP 连接吗?

不需要。提交后会返回 job_id;调用任务结果接口即可查看进度和已完成结果。

API 如何鉴权和计费?

使用 Bearer API Key。API 权限按当前会员套餐配置生效;查询按爱域查现有产品积分价格、缓存复用和失败退回规则执行。

有建议或发现问题?改进功能建议