POST /v1/batch-query
提交一批域名。每次任务只选择一种固定查询类型,减少契约复杂度。
公开 API 保持简单:WHOIS、ICP备案、微信拦截、域名被墙。提交任务后拿 job_id,再查询进度和结果;网页里的复杂分析、自定义工作流和内部工具接口不作为公开 API 契约。
{
"type": "whois",
"domains": [
"example.com",
"example.cn"
],
"locale": "zh"
}
→ {
"contract_version": "batch-query-v1",
"job_id": "...",
"type": "whois",
"status": "queued",
"total": 2
}
提交一批域名。每次任务只选择一种固定查询类型,减少契约复杂度。
读取任务状态、完成数、失败数以及每个域名已经生成的标准化结果。
Bearer odi_live_…
API 权限跟随会员套餐和后台套餐配置。
提交批量任务必须带稳定的 Idempotency-Key。相同请求重试不会重复创建任务或重复结算。
后端仍保留其他能力,但不再把内部模块和复杂工作流当成公开 API 契约。
whoisWHOIS / 注册信息
icpICP备案
wechat微信拦截
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
}
]
}
对外只承诺上面两个批量接口和四种 type。旧的单项工具、工作流、内部兼容路由继续服务现有产品,但不属于新的公开 API 文档与稳定契约。
| 契约版本 | batch-query-v1 |
|---|---|
| 提交 | POST /v1/batch-query |
| 结果 | GET /v1/batch-query/{job_id} |
| 执行方式 | 后台任务队列;无需保持长连接 |
第一版只开放四项固定批量查询:WHOIS、ICP备案、微信拦截和域名被墙检测。网页中的其他分析能力暂不作为公开 API 提供。
不需要。提交后会返回 job_id;调用任务结果接口即可查看进度和已完成结果。
使用 Bearer API Key。API 权限按当前会员套餐配置生效;查询按爱域查现有产品积分价格、缓存复用和失败退回规则执行。