全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件

恶意代码扫描接口

更新时间:2017-06-07 13:26:11

请求参数

名称父节点类型是否必须描述
AppInfoString(JSON格式的字符串)待恶意代码扫描的应用信息
dataTypeAppInfoNumberAPP数据类型:1-App URL,2-App MD5
dataAppInfoStringAPP数据:dataType=1时填写 App包的下载地址;dataType=2时填写 App包的md5值
md5AppInfoStringAPP包的MD5值,dataType=1时必填,用于文件校验
sizeAppInfoNumberAPP包大小(单位:字节),dataType=1时必填,用于文件校验
callbackUrlAppInfoString任务处理完成后的反向通知回调地址,dataType=1时必填,通知为GET请求,请求URL: callbackUrl+”?item_id=xxx&task_status=1”;item_id为恶意代码扫描接口返回的任务ID; task_status为任务状态:1-已完成,2-处理中,3-处理出错,4-处理超时;对于恶意代码扫描,如果task_status为1,3,4均可通过对应查询接口查询到结果,但不包括失败的扫描项的结果
appOsTypeAppInfoNumberapp 类型,1-apk
ExtParamString额外的信息,根据具体业务定

请求示例

https://jaq.aliyuncs.com/?Format=JSON&AccessKeyId=accessKeyId&Action=ScanMalware&SignatureMethod=HMAC-SHA1&ExtParam=xxx&RegionId=cn-hangzhou&AppInfo=%7B%22appOsType%22%3A1%2C%22callbackUrl%22%3A%22http%3A%2F%2Faaa.com%2Fcallback%22%2C%22data%22%3A%22http%3A%2F%2Fg01.alibaba-inc.com%2Ftfscom%2FLB1PaMeKXXXXXX8XFXXXXXXXXXX.tfsprivate1446115983140-375%22%2C%22dataType%22%3A1%2C%22md5%22%3A%22ce86f08da845d0af6d9df2a958de17b0%22%2C%22size%22%3A1713656%7D&SignatureNonce=4a733057-2adc-4f7f-b530-fd73fb6ad079&SignatureVersion=1.0&Version=2016-04-12&Signature=sVQVNw38rOCJdn6Nq8YN6CT9jTg%3D&Timestamp=2016-06-05T07%3A16%3A04Z

返回参数

名称父节点描述
Data返回结果
itemIdData任务唯一标识
progressData任务处理进度:1-处理完成(可立即通过对应的查询接口查询处理结果),2-异步处理中(需等待 app_info.callback_url 接收到反向通知后再查询结果);对于 app_info.data_type 为1目前都是异步处理,此字段返回2;对于 app_info.data_type 为2目前都是同步处理,此字段返回1

返回示例

JSON格式

  1. {
  2. "Data": {
  3. "ItemId": "adef0394-3370-4e94-82c6-07af0d15a9cd",
  4. "Progress": 2
  5. },
  6. "ErrorMsg": "Success",
  7. "ErrorCode": 0
  8. }

XML格式

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <ShieldResponse>
  3. <Data>
  4. <ItemId>e112d1ba-d058-4a96-ac1e-4b9f4986cf2e</ItemId>
  5. <Progress>2</Progress>
  6. </Data>
  7. <ErrorMsg>Success</ErrorMsg>
  8. <ErrorCode>0</ErrorCode>
  9. </ShieldResponse>
本文导读目录