使用建议

1. 已有 skill 信息时优先查询结果：先调用 GET /v3/skill/security/results，命中结果后无需提交扫描任务。
2. 只有文件时使用上传接口：调用 POST /v3/skill/security/upload 上传 zip 包，拿到 task_id 后调用 POST /v3/skill/security/tasks/batch 查看扫描状态。
3. 有下载地址且数量较多时使用批量提交：调用 POST /v3/skill/security/scan/batch 批量创建任务后再批量查看状态。
4. 按 code 而非 HTTP 状态码做错误分流（见「错误码说明」）。
5. 只对标记为可重试的错误重试：DependencyUnavailable（503）原样重发即可；NotSubscribed / ServiceStopped 重试无意义，需先到控制台开通或充值。
6. 自行去重：深度检测按 skill 个数计费，重复提交同一 Skill 会重复计费。

接口调试

• 线上调试页面：https://skill-sec.baidu.com/debug/v3-api/

  • 页面中需要填写的 AK/SK 请到百度智能云控制台获取。
  • 执行上传 URL / 文件扫描后，需使用服务端返回的 task_id 查询任务状态。

• zip 哈希计算调试页面：https://skill-sec.baidu.com/debug/v2-api/hash.html

  • 用于按 sha256 查询前，本地计算 zip 包 SHA256 与 zip 包内容 SHA256（content_sha256）。
  • 纯浏览器本地计算，不上传文件、不发起任何请求，算法口径与服务端一致，可用于比对自行实现的哈希是否正确。