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

alibaba.security.jaq.url.scan (恶意网址检测接口)

url扫描接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_url_scan_param_list UrlScanParamList 必须 扫描参数
  • url_scan_param_items
  • UrlScanParamItem []
  • 必须
  • 扫描参数列表
  • └ data
  • String
  • 必须
  • http://www.s.com
  • 需要扫描的url
  • └ flag
  • String
  • 必须
  • 1013
  • 参数标记,用于识别返回结果对应的参数

响应参数

名称 类型 示例值 描述
data UrlScanResult 扫描结果
  • └ event_id
  • String
  • e54d1afe-be16-4bcf-98fe-c206ea97a016
  • 请求标志唯一id
  • url_result_item_list
  • UrlScanResultItem []
  • 扫描详细结果
  • └ desc
  • String
  • 钓鱼网站风险描述
  • 风险类型的描述文字
  • └ flag
  • String
  • 1005
  • 用户传入的flag
  • └ official
  • String
  • www.icbc.com.cn
  • 被仿冒的官方网址
  • └ result_code
  • String
  • NOT_SAFE
  • 扫描结果码 SAFE-安全 NOT_SAFE-不安全 UN_KNOWN-未知
  • └ risk_type
  • String
  • Phishing
  • url风险类型 Phishing-钓鱼网站 Malware-恶意程序 Porn-色情网站 Gambling-赌博网站 Illegal-违法网站 Other-其他
  • └ source
  • String
  • CNCERT
  • 黑名单来源
  • └ target
  • String
  • 工商银行
  • 被钓鱼网站仿冒的对象

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSecurityJaqUrlScanRequest req = new AlibabaSecurityJaqUrlScanRequest();
UrlScanParamList obj1 = new UrlScanParamList();
List<UrlScanParamItem> list3 = new ArrayList<UrlScanParamItem>();
UrlScanParamItem obj4 = new UrlScanParamItem();
list3.add(obj4);
obj4.setData("http://www.s.com");
obj4.setFlag("1013");
obj1.setUrlScanParamItems(list3);
req.setParamUrlScanParamList(obj1);
AlibabaSecurityJaqUrlScanResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_security_jaq_url_scan_response>
    <data>
        <event_id>e54d1afe-be16-4bcf-98fe-c206ea97a016</event_id>
        <url_result_item_list>
            <url_scan_result_item>
                <desc>钓鱼网站风险描述</desc>
                <flag>1005</flag>
                <official>www.icbc.com.cn</official>
                <result_code>NOT_SAFE</result_code>
                <risk_type>Phishing</risk_type>
                <source>CNCERT</source>
                <target>工商银行</target>
            </url_scan_result_item>
        </url_result_item_list>
    </data>
</alibaba_security_jaq_url_scan_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

FAQ

返回
顶部