Web 应用防火墙 Skill安全检测上传接口

1. 接口描述

接口请求域名： waf.tencentcloudapi.com 。

上传Skill ZIP文件，触发异步安全检测

默认接口请求频率限制：3次/秒。

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：UploadSkillSecScan。
Version	是	String	公共参数，本接口取值：2018-01-25。
Region	是	String	公共参数，详见产品支持的地域列表，本接口仅支持其中的: ap-beijing, ap-chengdu, ap-chongqing, ap-guangzhou, ap-nanjing, ap-shanghai 。
ServiceId	是	String	服务ID 示例值：waf-test
FileData	是	String	zip压缩包base64编码后的数据示例值：UEsDBBQAAAAIAAAAISi9Qo7w6AIAANYFAAAIAAAAU0tJTEwubWRtVMFO3DAQvecr
FileName	否	String	skills文件压缩之后的文件名，.zip结尾示例值：f_20260427_111914_6743bc29.zip

3. 输出参数

参数名称	类型	描述
Data	SkillScanUploadData	上传结果
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 skill上传接口

**表示打码内容，调用放根据实际文件内容填充FileData

输入示例

POST / HTTP/1.1
Host: waf.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: UploadSkillSecScan
<公共请求参数>

{
    "ServiceId": "waf-test",
    "FileName": "f_20260427_111914_6743bc29.zip",
    "FileData": "UEsDBBQAAAAIAAAAISi9Qo7w6AIAANYFAAAIAAAAU0tJTEwubWRtVMFO3DAQvecrRuICdMmqpaUSt2pBalWEENDtNSaZJKN1bNd2loZDv70zTja7pdziZPLemzd**ATf+yf0BiMGWOk+RPSwsp2zBk2EK************R9D6clFsib70kfb**********i2B**MY5Tmh9qrEH1fxt4jlD**/s*COu*uR+4cHlsKEDakNWyVpmqm**o3GH**jGVqanqvRM0C8DeW/RtqHD**ZB**b7v0cRbn0dlA0fphAcpU4NDX****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"
}

输出示例

{
    "Response": {
        "Data": {
            "ContentHash": "sha256:efbc9937af7cd8fa4835908d753dd6272a521da849b2cfdb58b5f5f281c79a4a",
            "Message": "检测记录已存在，无需重复上传",
            "Status": "success"
        },
        "RequestId": "c175da86-5773-410a-80e0-e9aa2b8d94f1"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameter.SkillScanApiKeyDisabled	API Key 已被禁用
InvalidParameter.SkillScanCreateScanFailed	创建扫描任务失败（服务内部错误）
InvalidParameter.SkillScanInvalidBase64	FileData 不是有效的 Base64 编码
InvalidParameter.SkillScanInvalidFileFormat	文件不是有效的 ZIP 格式
InvalidParameter.SkillScanInvalidParam	参数校验失败（如 content_hash 格式不合法、缺少必填字段）
InvalidParameter.SkillScanInvalidRequest	请求格式错误（如 Content-Type 不正确、JSON 解析失败）
InvalidParameter.SkillScanNoFiles	未检测到上传文件
InvalidParameter.SkillScanQueryFailed	查询失败（服务内部错误）
InvalidParameter.SkillScanRateLimitExceeded	请求频率超出限制
InvalidParameter.SkillScanServiceIdEmpty	ServiceId 为空
InvalidParameter.SkillScanSwitchOff	防护开关未开启
InvalidParameter.SkillScanTriggerFailed	触发检测任务失败（服务内部错误）
InvalidParameter.SkillScanUnauthorized	API Key 缺失或无效

Skill安全检测上传接口

本页目录：