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

alibaba.security.jaq.app.risksummary.get (应用风险概要信息查询接口)

用户通过alibaba.security.jaq.app.risk.scan接口提交应用进行风险扫描后，用此接口获取风险概要信息，本接口不返回风险详细信息

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
item_id	String	可选	0217beb9-87ac-4d01-ae37-a51448a261ff		任务唯一标识

响应参数

名称	类型	示例值	描述
result	RiskSummary		应用扫描概要信息
fake_info FakeAppSummary 仿冒应用信息 └ fake_app_count Number 13 仿冒应用总数(任务完成时才返回) └ status Number 1 子任务状态: 1-已完成,2-处理中,3-处理出错,4-处理超时 └ total_infected_users Number 31 仿冒应用感染用户总数(任务完成时才返回) malware_info MalwareSummary 恶意代码信息 malware_count MalwareCount 恶意代码数量信息(任务完成时才返回) └ high_level Number 1 高风险恶意代码数量 └ low_level Number 1 低风险恶意代码数量 └ total Number 2 恶意代码总数量 └ weak_level Number 1 若风险恶意代码数量 └ status Number 1 子任务状态: 1-已完成,2-处理中,3-处理出错,4-处理超时 plugin_info PluginSummary 插件信息 └ plugin_count Number 1 插件个数 └ status Number 1 子任务状态: 1-已完成,2-处理中,3-处理出错,4-处理超时 └ task_status Number 1 任务总状态: 1-已完成,2-处理中,3-处理失败,4-处理超时 vuln_info VulnSummary 漏洞信息 └ status Number 1 子任务状态: 1-已完成,2-处理中,3-处理出错,4-处理超时 vuln_count VulnCount 漏洞数量信息(任务完成时才返回) └ high_level Number 1 高风险漏洞数量 └ low_level Number 1 低风险漏洞数量 └ mid_level Number 1 中风险漏洞数量 └ red_line Number 1 红线漏洞数量 └ total Number 3 漏洞总数量 └ task_error_code String 0 漏洞任务错误码 0-成功其他-错误 └ task_error_msg String success 漏洞任务错误信息 succes-成功其他-错误

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSecurityJaqAppRisksummaryGetRequest req = new AlibabaSecurityJaqAppRisksummaryGetRequest();
req.setItemId("0217beb9-87ac-4d01-ae37-a51448a261ff");
AlibabaSecurityJaqAppRisksummaryGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<alibaba_security_jaq_app_risksummary_get_response>
    <result>
        <fake_info>
            <fake_app_count>13</fake_app_count>
            <status>1</status>
            <total_infected_users>31</total_infected_users>
        </fake_info>
        <malware_info>
            <malware_count>
                <high_level>1</high_level>
                <low_level>1</low_level>
                <total>2</total>
                <weak_level>1</weak_level>
            </malware_count>
            <status>1</status>
        </malware_info>
        <plugin_info>
            <plugin_count>1</plugin_count>
            <status>1</status>
        </plugin_info>
        <task_status>1</task_status>
        <vuln_info>
            <status>1</status>
            <vuln_count>
                <high_level>1</high_level>
                <low_level>1</low_level>
                <mid_level>1</mid_level>
                <red_line>1</red_line>
                <total>3</total>
            </vuln_count>
            <task_error_code>0</task_error_code>
            <task_error_msg>success</task_error_msg>
        </vuln_info>
    </result>
</alibaba_security_jaq_app_risksummary_get_response>

异常示例

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码	错误描述	解决方案
isv.param-error	请求参数错误	请检查输入参数
isp.server-error	服务端错误	服务端处理错误，请稍后进行重试

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部