跳到正文

网址安全信息查询

接口说明

通过网址url,查询网址安全级别等信息。级别、子级别对应的威胁类型已映射成易识别的码表。 一次最多查20个网址,超过部分无效,只查前20个。

响应报文level级别描述说明:

level级别黑白情况恶意类型
0白非恶意网址
98白用户自定义添加的url白名单
99白未知级别的 url,可以按安全处理
1黑挂马网址
2黑篡改首页等网址
3黑钓鱼、欺诈网址
4黑恶意软件下载网址
5黑木马、下载者网址
6黑其它类型的恶意网址
7黑赌博网址
8黑色情网址
9黑特殊网址
10黑金融证券钓鱼欺诈
11黑虚假购物钓鱼欺诈
12黑仿冒银行钓鱼欺诈
13黑违禁品
14黑管制刀具、枪械类
97黑用户自定义添加的url黑名单

请求示例报文格式:

{
  "data": [
    {
      "url": "http://map.so.com/?src=tab_web",
      "exts": []
    },
    {
      "url": "http://shouji.360.cn/index.html",
      "exts": []
    }
  ],
  "exts": []
}

请求地址

https://api.f.360.cn/urls/std/v2/cloud_safe_info

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
dataArray(Object)body是见下方示例查询的网址集合,单个请求最多携带20个网址,超过部分无效,只查前20个
data[].urlstringbody是http://map.so.com/查询网址的url值
data[].extsArray(Object)body否
[
  {
    "key": "title",
    "value": "..."
  }
]
查询查询网址的扩展字段,可为空
data[].exts.keystringbody是title查询网址的扩展字段:字段名
data[].exts.valuestringbody是360地图 – 出门之前,搜一下查询网址的扩展字段:具体值
extsArray(Object)body否
[
  {
    "key": "browser",
    "value": "..."
  }
]
本次请求全局扩展字段,可为空
exts.keystringbody是本次请求全局扩展字段:字段名
exts.valuestringbody是本次请求全局扩展字段:具体值

响应参数

名称类型示例值描述
codestring0响应状态码,0为正常
msgstringsuccess响应状态信息
dataobject见下方示例网址查询结果
data.extsArray(object)
[]
本次响应全局扩展字段
data.exts[].keystring本次响应全局扩展字段:字段名
data.exts[].valuestring本次响应全局扩展字段:具体值
data.resultsArray(object)见下方示例响应的网址集合
data.results[].urlstringhttp://map.so.com/响应网址的url值
data.results[].infoobject
{
  "level": 99
}
响应网址的详细信息
data.results[].info.levelnumber99查询的网址风险级别

Level级别说明

Level黑白情况恶意类型
0白非恶意网址
98白用户自定义添加的url白名单
99白未知级别的url,可以按安全处理
1黑挂马网址
2黑篡改首页等网址
3黑钓鱼、欺诈网址
4黑恶意软件下载网址
5黑木马、下载者网址
6黑其它类型的恶意网址
7黑赌博网址
8黑色情网址
9黑特殊网址
10黑金融证券钓鱼欺诈
11黑虚假购物钓鱼欺诈
12黑仿冒银行钓鱼欺诈
13黑违禁品
14黑管制刀具、枪械类
97黑用户自定义添加的url黑名单

请求示例

支持cUrl、Python、Java、PHP、Go语言的请求,示例如下

#!/usr/bin/env bash
set -euo pipefail

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/urls/std/v2/cloud_safe_info"
BODY='{"data":[{"url":"http://map.so.com/?src=tab_web"}]}'

NONCE=$(printf '%08d' $((RANDOM % 100000000)))
TIMESTAMP=$(date +%s)
BODY_MD5=$(printf '%s' "$BODY" | openssl dgst -md5 -hex | awk '{print $NF}')
SIGNATURE=$(printf '%s' "${BODY_MD5}${APPID}${NONCE}${TIMESTAMP}${SECRET}" | openssl dgst -md5 -hex | awk '{print $NF}')
SIGNATURE=${SIGNATURE:16}

curl --location --request POST "$URL" \
  --header "Content-Type: application/json" \
  --header "X-360-Key: ${APPID}" \
  --header "X-360-Nonce: ${NONCE}" \
  --header "X-360-Timestamp: ${TIMESTAMP}" \
  --header "X-360-Signature: ${SIGNATURE}" \
  --data "${BODY}"

响应示例

{
    "code": "0",
    "msg": "success",
    "data": {
        "results": [
            {
                "info": {
                    "level": 2
                },
                "url": "http://wangzhi2.dhtz333.top/"
            },
            {
                "info": {
                    "level": 8
                },
                "url": "http://q7d.hebzyp.cn"
            },
            {
                "info": {
                    "level": 0
                },
                "url": "www.xuexila.com"
            }
        ],
        "exts": []
    }
}