微步在线云 API

文件反病毒引擎检测报告

获取文件经过 22 款反病毒扫描引擎检测后的结果。

调用脚本

请求方法

请求地址： https://api.threatbook.cn/v3/file/report/multiengines

请求方式：POSTGET

使用说明

适用场景： 该接口适用于快速获取文件多引擎检测结果，可用于邮件附件初筛、文件上传检测、终端样本快速判定和轻量级告警富化。相关场景示例可参考：IM/邮件防钓鱼。

使用建议： 建议在只需要快速判断文件是否被多引擎检出时调用。若需要查看样本行为、网络通信、释放文件或静态信息，应继续调用文件信誉报告接口。

响应字段解读建议： 建议优先综合参考 multiengines.threat_level、positives、total、scan_date、malware_type 和 malware_family 判断风险程度和检出一致性；单个引擎检出可作为线索，多引擎一致检出更适合支撑自动化处置。

请求参数说明

序号	参数名称	必选	类型	描述
1	apikey	是	string	API请求的身份识别标识。
2	resource	是	string	文件的hash值，用于获取分析报告。支持sha256/sha1/md5。

响应参数说明

序号	参数名称	类型	描述	使用说明
1	response_code	int	响应正常会返回"0"。其他Response code及对应msg描述参见"响应Code和Msg对照表"	用于判断本次请求是否成功。业务系统应先判断该字段，再解析 data 内的业务结果；非 0 时建议按异常请求处理。
2	verbose_msg	string	响应正常会返回"Ok"。其他Response code及对应msg描述参见"响应Code和Msg对照表"	用于展示或记录接口返回说明，适合写入调用日志和错误排查信息；自动化流程建议以 response_code 为主要判断依据。
3	multiengines	object	多引擎扫描报告。JSON对象。每个item描述如下： threat_level：威胁等级： malicious：恶意 suspicious: 可疑 clean: 安全 unknown: 未知 total：反病毒扫描引擎检测成功的个数。 total2：实际部署的反病毒扫描引擎个数。 positives：反病毒扫描引擎检出的个数。 scan_date：最近扫描时间。 malware_type：病毒类型，如DoS等。 malware_family：病毒家族，如Xorddos等。 scan：反病毒扫描引擎检测结果。每个item是1个扫描引擎检测结果，检测结果说明如下：无检出：显示为safe。有检出：显示具体的检出的病毒结果标签。如：Trojan。	用于快速查看文件多引擎检测结论和检出明细，适合轻量级文件风险判断和告警富化。

请求示例

微步在线云API支持cURL、Python、PHP、Java、Go语言的请求，以Python为例：

Python

cURL

PHP

Java

Python

import requests

url = 'https://api.threatbook.cn/v3/file/report/multiengines'
params = {
    'apikey': '请替换apikey',
    'resource': '请替换文件hash值'
}
response = requests.get(url, params=params)
print(response.json())

响应示例（JSON）

{ 
  "response_code": 0, 
  "data": {   
    "multiengines": {
      "threat_level": "malicious",      // 威胁等级(malicious 恶意, suspicious 可疑, clean 安全, unknown 未知)
      "total": 22,      // 反病毒扫描引擎检测成功的个数     
      "scans": {        // 反病毒扫描引擎检测结果(safe 无检出，e.g Trojan 检出结果)       
        "vbwebshell": "safe",       
        "Avast": "safe",       
        "Rising": "Trojan.Linux.DDoS-Xor.a",       
        "K7": "safe",       
        "Kaspersky": "safe",       
        "NANO": "safe",       
        "Baidu-China": "safe",       
        "Microsoft": "DoS:Linux/Xorddos!rfn",       
        "ClamAV": "safe",       
        "IKARUS": "safe",       
        "Huorong": "Trojan/Linux.Xorddos.b",       
        "Avira": "safe",      
        "Sophos": "Linux/DDoS-BH",       
        "Panda": "safe",       
        "Antiy": "safe",       
        "AVG": "Trojan horse Linux/Generic_c.HN",       
        "Baidu": "safe",       
        "DrWeb": "safe",       
        "GDATA":"Trojan.Linux.Generic.7404",       
        "Qihu360": "safe",       
        "ESET": "Linux/Xorddos.F trojan",       
        "JiangMin": "TrojanDDoS.Linux.bn"     
      },    
      "is_white": false,                  // 是否为白名单文件，true 白名单     
      "total2": 22,                      // 实际部署的反病毒扫描引擎个数     
      "positives": 9,                     // 反病毒扫描引擎检出的个数     
      "scan_date": "2019-01-22 13:23:55",       // 最近扫描时间     
      "malware_type": "DoS",                 // 病毒类型     
      "malware_family": "Xorddos"         // 病毒家族   
    } 
  }, 
  "verbose_msg": "OK"
}

云API是北京微步在线科技有限公司旗下产品了解微步在线《用户服务条款》《数据保护政策》

联系我们：api@threatbook.cn

#文件反病毒引擎检测报告

#调用脚本

#请求方法

#使用说明

#请求参数说明

#响应参数说明

#请求示例

#响应示例（JSON）