公有云查

最近更新时间:2019-02-22 15:53:46

1. 接口描述

接口请求域名: tav.tencentcloudapi.com 。

通过文件哈希值获取文件黑白属性

默认接口请求频率限制:20次/秒。

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:ScanFileHash
Version String 公共参数,本接口取值:2019-01-18
Region String 公共参数,本接口不需要传递此参数。
Key String 购买服务后获得的授权信息,用于保证请求有效性
Md5s String 需要查询的md5值(支持单个和多个,多个md5间用逗号分格)
WithCategory String 保留字段默认填0
SensitiveLevel String 松严规则控制字段默认填10(5-松、10-标准、15-严)

3. 输出参数

参数名称 类型 描述
Status Integer 接口调用状态,成功返回200,失败返回400
Info String 接口调用描述信息,成功返回"scan success",失败返回"scan error"
Data String 云查实际结果信息,包括md5、return_state、virus_state、virus_name字符逗号间隔;
return_state查询状态:-1/0代表失败、1/2代表成功;
virus_state文状件态:0文件不存在、1白、2黑、3未知、4感染性、5低可信白;
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 TAV公有云查

输入示例

https://tav.tencentcloudapi.com/?Action=ScanFileHash
&Key=d12790cf44382a3c15e4e8c63e41e74d
&Md5s=0f600011f6abb02f6a117e1efb952a3c
&WithCategory=0
&SensitiveLevel=10
&<公共请求参数>

输出示例

{"Response": {"Status": 200, "Info": "scan success", "Data": "md5:0f600011f6abb02f6a117e1efb952a3c,return_state:1,virus_state:2,virus_name:Win32.Trojan.Agent.tkxh|", "RequestId": "00f29851-2408-4818-b66c-3b2d2ba4196f"}}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

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

命令行工具

6. 错误码

该接口暂无业务逻辑相关的错误码,其他错误码详见公共错误码