批量查询任务状态接口
更新时间:2026-09-22
通过一个或多个 task_id 批量查询扫描任务状态。推荐用于轮询上传任务和批量 URL 扫描任务。
Plain Text
1POST /v3/skill/security/tasks/batch
- 是否计费:不计费。停服/未开通账号仍可调用。
- 归属过滤:非本账号的
task_id一律返回status: "not_found"。
轮询建议策略:前 3 次每 5s 一次,之后每 15s 一次,超过 10 分钟未完成则中止并报超时。
请求参数(Request Body · JSON)
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| task_ids | array | 必填 | 要查询的任务 ID 列表,最多 100 个 |
请求示例
JSON
1{
2 "task_ids": [
3 "upload-v3-550e8400-e29b-41d4-a716-446655440000",
4 "url-v3-650e8400-e29b-41d4-a716-446655440001"
5 ]
6}
响应结构
处理中
JSON
1{
2 "code": "success", "message": "success", "ts": 1773822833794,
3 "data": { "tasks": [
4 { "task_id": "upload-v3-550e8400-e29b-41d4-a716-446655440000", "status": "processing", "created_at": 1773822833000, "updated_at": 1773822840000 }
5 ] }
6}
完成
results 中的结果字段,参照「查询 Skill 安全结果」接口的 data 数组元素。
JSON
1{
2 "code": "success", "message": "success", "ts": 1773826508023,
3 "data": { "tasks": [
4 {
5 "task_id": "upload-v3-550e8400-e29b-41d4-a716-446655440000",
6 "status": "done",
7 "created_at": 1773822833000,
8 "updated_at": 1773822856000,
9 "results": [
10 {
11 "slug": "my-skill", "version": "1.0.2", "source": "openclaw",
12 "sha256": "42d41782d4c3c790e22e0eb26a444ea386e234cbdd75b9a57a10a55dab6ca98e",
13 "bd_confidence": "safe",
14 "bd_describe": "Skill Scanner 扫描无威胁检出。综合评估为:安全可信。",
15 "scanned_at": 1773822856000,
16 "detail": {},
17 "permission": { "has_scripts": true, "has_binaries": false, "categories_hit": ["network"], "rule_ids_hit": ["PERM-NET-001"], "findings": [], "scanned_at": 1773822856000 },
18 "compliance_risk": { "category_count": 0, "subcategory_count": 0, "scanned_at": 1773822856000 }
19 }
20 ]
21 }
22 ] }
23}
任务不存在
不存在的 task_id 不会导致整个请求失败,会在对应项返回 status: "not_found"(非本账号的任务同样返回该状态)。
JSON
1{
2 "code": "success", "message": "success", "ts": 1773826508023,
3 "data": { "tasks": [ { "task_id": "url-not-exists", "status": "not_found" } ] }
4}
失败
JSON
1{
2 "code": "success", "message": "success", "ts": 1776417182874,
3 "data": { "tasks": [
4 { "task_id": "url-v3-e4a60527-e44e-470f-847f-8942dc23c564", "status": "failed", "created_at": 1776409164000, "updated_at": 1776409166000, "error_message": "Failed to process the uploaded file" }
5 ] }
6}
任务字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| data.tasks[].task_id | string | 任务 ID |
| data.tasks[].status | string | 任务状态,见「任务状态枚举」 |
| data.tasks[].created_at | number | 创建时间戳(毫秒) |
| data.tasks[].updated_at | number | 更新时间戳(毫秒) |
| data.tasks[].error_message | string | 失败原因,仅failed 时返回 |
| data.tasks[].results | array | 完成时的检测结果数组,元素同「查询 Skill 安全结果」的data[] |
评价此篇文章
