跳到正文

域名恶意网址查询

接口说明

通过输入一个域名domain,查询该域名下近 3 个月的历史 URL,筛选出 高风险等级(恶意)的 URL,以URL网址列表的形式返回。其中“恶意 URL” 的定义是“云判定接口返回风险等级>30 的 URL”。该接口的业务目的是对域名做风险佐证。通过添加sort参数,可以保证数据一致性。

推荐应用场景

通过domain关联的恶意url列表,作为参照,来对domain做风险标注。

请求地址

https://api.f.360.cn/domains/std/internal/v2/malice_url

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
queryobjectbody是
{
  "keywords": [
    {
      "field": "domain",
      "value": "0779hf.com"
    }
  ]
}
查询条件,所有请求参数的父级结构
query.keywordsArray(object)body是
[
  {
    "field": "domain",
    "value": "0779hf.com"
  }
]
查询条件,所有请求参数的子级结构
query.keywords.[0].fieldstringbody是domain查询条件的字段名,支持的字段为domain
query.keywords.[0].valuestringbody是0779hf.com查询条件的字段值,为单个域名
query.keywords.[1].fieldstringbody否sort查询条件的字段名,支持的字段为sort。用户通过指定sort可以保证数据一致性
query.keywords.[1].valuestringbody否asc查询条件的字段值,支持的值为asc、desc
query.pagenationobjectbody否
{
  "pageNum_": 1,
  "pageSize_": 20
}
分页信息,包括分页偏移量 pageNum_和分页大小pageSize_
query.pagenation.pageNum_integerbody否1分页偏移量,默认值:1
query.pagenation.pageSize_integerbody否10分页大小,默认值:10

响应参数

名称类型示例值描述
codestring0响应状态码
dataArray
[
  "http://0779hf.com",
  "http://0779hf.com",
  "http://0779hf.com/vodplay/83355-4-3.html",
  "http://0779hf.com",
  "http://0779hf.com",
  "http://0779hf.com",
  "http://0779hf.com",
  "http://0779hf.com",
  "http://0779hf.com/statics/qis/404.html",
  "http://0779hf.com"
]
根据域名查询出的恶意URL列表
msgstringok响应状态信息
statusnumber0目前没有实际意义,固定输出0

请求示例

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

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

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/domains/std/internal/v2/malice_url"
BODY='{"query":{"keywords":[{"field":"domain","value":"00yqs00.com"}]}}'

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}"

响应示例

业务正常响应

{
    "_oid": 1,
    "code": "0",
    "data": [
        "https://0779hf.com",
        "http://0779hf.com",
        "https://0779hf.com",
        "http://0779hf.com",
        "http://0779hf.com"
    ],
    "msg": "ok",
    "status": 0
}

业务异常响应

{
  "code": "GS00301",
  "msg": "param missing"
}