{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Cmucox41h","result":{"data":{"markdownRemark":{"html":"

通过一个或多个 task_id 批量查询扫描任务状态。推荐用于轮询上传任务和批量 URL 扫描任务。

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /v3/skill/security/tasks/batch
\n
\n
\n
\n \n\n

轮询建议策略：前 3 次每 5s 一次，之后每 15s 一次，超过 10 分钟未完成则中止并报超时。

\n

请求参数（Request Body · JSON）

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名类型是否必填说明
task_idsarray必填要查询的任务 ID 列表，最多 100 个
\n

请求示例

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"task_ids\": [\n3    \"upload-v3-550e8400-e29b-41d4-a716-446655440000\",\n4    \"url-v3-650e8400-e29b-41d4-a716-446655440001\"\n5  ]\n6}
\n
\n
\n
\n \n

响应结构

\n

处理中

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"code\": \"success\", \"message\": \"success\", \"ts\": 1773822833794,\n3  \"data\": { \"tasks\": [\n4    { \"task_id\": \"upload-v3-550e8400-e29b-41d4-a716-446655440000\", \"status\": \"processing\", \"created_at\": 1773822833000, \"updated_at\": 1773822840000 }\n5  ] }\n6}
\n
\n
\n
\n \n

完成

\n

results 中的结果字段，参照「查询 Skill 安全结果」接口的 data 数组元素。

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"code\": \"success\", \"message\": \"success\", \"ts\": 1773826508023,\n3  \"data\": { \"tasks\": [\n4    {\n5      \"task_id\": \"upload-v3-550e8400-e29b-41d4-a716-446655440000\",\n6      \"status\": \"done\",\n7      \"created_at\": 1773822833000,\n8      \"updated_at\": 1773822856000,\n9      \"results\": [\n10        {\n11          \"slug\": \"my-skill\", \"version\": \"1.0.2\", \"source\": \"openclaw\",\n12          \"sha256\": \"42d41782d4c3c790e22e0eb26a444ea386e234cbdd75b9a57a10a55dab6ca98e\",\n13          \"bd_confidence\": \"safe\",\n14          \"bd_describe\": \"Skill Scanner 扫描无威胁检出。综合评估为：安全可信。\",\n15          \"scanned_at\": 1773822856000,\n16          \"detail\": {},\n17          \"permission\": { \"has_scripts\": true, \"has_binaries\": false, \"categories_hit\": [\"network\"], \"rule_ids_hit\": [\"PERM-NET-001\"], \"findings\": [], \"scanned_at\": 1773822856000 },\n18          \"compliance_risk\": { \"category_count\": 0, \"subcategory_count\": 0, \"scanned_at\": 1773822856000 }\n19        }\n20      ]\n21    }\n22  ] }\n23}
\n
\n
\n
\n \n

任务不存在

\n

不存在的 task_id 不会导致整个请求失败，会在对应项返回 status: \"not_found\"（非本账号的任务同样返回该状态）。

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"code\": \"success\", \"message\": \"success\", \"ts\": 1773826508023,\n3  \"data\": { \"tasks\": [ { \"task_id\": \"url-not-exists\", \"status\": \"not_found\" } ] }\n4}
\n
\n
\n
\n \n

失败

\n\n
\n
\n
\n JSON\n \n
\n
\n 
1{\n2  \"code\": \"success\", \"message\": \"success\", \"ts\": 1776417182874,\n3  \"data\": { \"tasks\": [\n4    { \"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\" }\n5  ] }\n6}
\n
\n
\n
\n \n

任务字段说明

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段名类型说明
data.tasks[].task_idstring任务 ID
data.tasks[].statusstring任务状态，见「任务状态枚举」
data.tasks[].created_atnumber创建时间戳（毫秒）
data.tasks[].updated_atnumber更新时间戳（毫秒）
data.tasks[].error_messagestring失败原因，仅failed 时返回
data.tasks[].resultsarray完成时的检测结果数组，元素同「查询 Skill 安全结果」的data[]
","fields":{"slug":"Cmucox41h","title":"批量查询任务状态接口","date":"2026-09-22","extractedHeadings":[]},"headings":[{"value":"请求参数（Request Body · JSON）","depth":2},{"value":"请求示例","depth":2},{"value":"响应结构","depth":2},{"value":"处理中","depth":3},{"value":"完成","depth":3},{"value":"任务不存在","depth":3},{"value":"失败","depth":3},{"value":"任务字段说明","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Cmucox41h","prev":{"id":"qmucovmgf","name":"Skill 深度检测接口","path":"qmucovmgf","filePath":"API参考/Skill安全检测服务接口/接口清单/Skill 深度检测接口.md","seo":null,"parentIds":["Pmuazlcz0","xmuazm19h","nmucni04m"],"parents":[{"id":"Pmuazlcz0","documentId":"d6b82d73-73ba-4bca-af5d-844538a67518","name":"API参考","repoName":"ASC","filePath":"API参考","disabled":false,"path":"Pmuazlcz0","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmuazm19h","documentId":"fe982a7e-bf8f-4fd2-912e-5e590ba600f2","name":"Skill安全检测服务接口","repoName":"ASC","filePath":"API参考/Skill安全检测服务接口","disabled":false,"path":"xmuazm19h","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmucni04m","documentId":"66347176-4bc2-4e27-a6e2-ca3c3f0c47cf","name":"接口清单","repoName":"ASC","filePath":"API参考/Skill安全检测服务接口/接口清单","disabled":false,"path":"nmucni04m","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Emucozxum","name":"查询用量接口","path":"Emucozxum","filePath":"API参考/Skill安全检测服务接口/接口清单/查询用量接口.md","seo":null,"parentIds":["Pmuazlcz0","xmuazm19h","nmucni04m"],"parents":[{"id":"Pmuazlcz0","documentId":"d6b82d73-73ba-4bca-af5d-844538a67518","name":"API参考","repoName":"ASC","filePath":"API参考","disabled":false,"path":"Pmuazlcz0","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmuazm19h","documentId":"fe982a7e-bf8f-4fd2-912e-5e590ba600f2","name":"Skill安全检测服务接口","repoName":"ASC","filePath":"API参考/Skill安全检测服务接口","disabled":false,"path":"xmuazm19h","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmucni04m","documentId":"66347176-4bc2-4e27-a6e2-ca3c3f0c47cf","name":"接口清单","repoName":"ASC","filePath":"API参考/Skill安全检测服务接口/接口清单","disabled":false,"path":"nmucni04m","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Pmuazlcz0","documentId":"d6b82d73-73ba-4bca-af5d-844538a67518","name":"API参考","repoName":"ASC","filePath":"API参考","disabled":false,"path":"Pmuazlcz0","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmuazm19h","documentId":"fe982a7e-bf8f-4fd2-912e-5e590ba600f2","name":"Skill安全检测服务接口","repoName":"ASC","filePath":"API参考/Skill安全检测服务接口","disabled":false,"path":"xmuazm19h","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmucni04m","documentId":"66347176-4bc2-4e27-a6e2-ca3c3f0c47cf","name":"接口清单","repoName":"ASC","filePath":"API参考/Skill安全检测服务接口/接口清单","disabled":false,"path":"nmucni04m","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}