淘宝开放平台

登录
文档中心 > API类目 > 聚安全API

聚安全API

alibaba.security.jaq.app.risk.scanbatch (应用风险扫描批量提交接口)

批量提交应用进行风险扫描(含漏洞扫描、恶意代码检测),扫描完成后可通过对应的查询接口查询扫描结果

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
app_info AppInfoBatch 必须 APP信息
  • └ app_os_type
  • Number
  • 必须
  • 1
  • APP应用类型 1-android 2-ios(暂不支持)
  • └ callback_url
  • String
  • 可选
  • http://my.callback
  • 回调地址,dataType=4时必填,用于处理完成后反向通知,通知为GET请求,请求格式: callbackUrl+"?itemId=xxx&taskStatus=1"
  • └ data_type
  • Number
  • 必须
  • 3
  • APP数据类型 3-Batch MD5 4-Batch URL(暂不支持)
  • scan_infos
  • AppInfoBatchItem []
  • 必须
  • 需要扫描的应用的具体信息列表
  • └ data
  • String
  • 必须
  • b957a597266f4e1f953bbc1b23fbccf7
  • 待扫描的应用信息dataType=3时填应用的md5 dataType=4时填应用的url
  • └ md5
  • String
  • 可选
  • b957a597266f4e1f953bbc1b23fbccf7
  • 应用的md5，dataType＝4时必填
  • └ size
  • Number
  • 可选
  • 10213
  • 应用的大小(单位byte)，dataType＝4时必填
scan_types String [] 必须 malware
  • 最大列表长度：20
    		•  扫描类型

    响应参数

    名称 类型 示例值 描述
    result TaskInfo 扫描任务信息
    • └ item_id
    • String
    • 0217beb9-87ac-4d01-ae37-a51448a261ff
    • 任务唯一标识
    • └ progress
    • Number
    • 1
    • 任务处理进度: 1-处理完成 (可立即通过对应的查询接口查询处理结果), 2-异步处理中(需等待app_info.callback_url接收到反向通知后再查询结果) ; 对于app_info.data_type为4目前都是异步处理，此字段返回2; 对于app_info.data_type为3目前都是同步处理，此字段返回1

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaSecurityJaqAppRiskScanbatchRequest req = new AlibabaSecurityJaqAppRiskScanbatchRequest();
    AlibabaSecurityJaqAppRiskScanbatchRequest.AppInfoBatch obj1 = new AlibabaSecurityJaqAppRiskScanbatchRequest.AppInfoBatch();
    obj1.setAppOsType(1L);
    obj1.setCallbackUrl("http://my.callback");
    obj1.setDataType(3L);
    List<AlibabaSecurityJaqAppRiskScanbatchRequest.AppInfoBatchItem> list3 = new ArrayList<AlibabaSecurityJaqAppRiskScanbatchRequest.AppInfoBatchItem>();
    AlibabaSecurityJaqAppRiskScanbatchRequest.AppInfoBatchItem obj4 = new AlibabaSecurityJaqAppRiskScanbatchRequest.AppInfoBatchItem();
    list3.add(obj4);
    obj4.setData("b957a597266f4e1f953bbc1b23fbccf7");
    obj4.setMd5("b957a597266f4e1f953bbc1b23fbccf7");
    obj4.setSize(10213L);
    obj1.setScanInfos(list3);
    req.setAppInfo(obj1);
    req.setScanTypes("malware");
    AlibabaSecurityJaqAppRiskScanbatchResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <alibaba_security_jaq_app_risk_scanbatch_response>
        <result>
            <item_id>0217beb9-87ac-4d01-ae37-a51448a261ff</item_id>
            <progress>1</progress>
        </result>
    </alibaba_security_jaq_app_risk_scanbatch_response>

    异常示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部