接口请求域名: waf.intl.tencentcloudapi.com 。
根据文件Hash查询Skill安全检测结果
默认接口请求频率限制:20次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:DescribeSkillSecScanResult。 |
| Version | 是 | String | 公共参数,本接口取值:2018-01-25。 |
| Region | 是 | String | 公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-hongkong, ap-jakarta, ap-singapore 。 |
| ServiceId | 是 | String | 服务ID |
| ContentHash | 是 | String | ZIP 文件的 SHA256 哈希值,格式为 sha256:hex_digest,请严格遵循文档中的zip打包规范 |
| Lang | 否 | String | 返回语言。支持 zh / en,默认 zh |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Data | SkillScanQueryData | 检测结果 |
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
ServiceId和ContentHash 请调用方按照实际情况填充
POST / HTTP/1.1
Host: waf.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeSkillSecScanResult
<公共请求参数>
{
"ServiceId": "******",
"ContentHash": "sha256:efbc*937af7cd8fa4835908d753dd6272*521da849b2cfdb58b5f5f281c79a*a",
"Lang": "zh"
}
{
"Response": {
"Data": {
"CapabilityTags": [
{
"Id": "command_execution",
"Name": "命令执行"
}
],
"ContentHash": "sha256:efbc9937af7cd8fa4835908d753dd6272a521da849b2cfdb58b5f5f281c79a4a",
"EngineVersion": 40400,
"ReportUrl": "http://test-static-ai-scan.woa.com/html-reports/2026/05/07/125821_16d02efc38ccc323445bbcc0c97bb050.html",
"RiskLevel": "malicious",
"RuleCatalog": [
{
"Key": "90005",
"Value": "Prompt 注入风险"
}
],
"ScanItems": [
{
"RuleList": [
{
"Description": "在 scripts/run.py 第 10 行发现 subprocess.run(cmd, shell=True) 通过 shell 执行命令;在 scripts/run.py 第 34 行发现 curl -sfL | bash 下载并执行远程脚本;在 scripts/run.py 第 54 行发现 unset HISTFILE 禁用 shell 历史记录",
"RuleId": "90002"
}
],
"ScanType": "AI"
}
],
"ScannedAt": "2026-05-07T19:19:59+08:00",
"SecurityScore": 11,
"Status": "success"
},
"RequestId": "ed07db13-df4d-4dde-97df-9bd1bd1b4df8"
}
}
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameter.SkillScanInvalidParam | 参数校验失败(如 content_hash 格式不合法、缺少必填字段) |
| InvalidParameter.SkillScanInvalidRequest | 请求格式错误(如 Content-Type 不正确、JSON 解析失败) |
| InvalidParameter.SkillScanQueryFailed | 查询失败(服务内部错误) |
| InvalidParameter.SkillScanServiceIdEmpty | ServiceId 为空 |
| InvalidParameter.SkillScanSwitchOff | 防护开关未开启 |
文档反馈