跳到正文

URL快照概要信息查询

接口说明

根据url、cname、host、domain、ip、url_md5查询网址快照概要信息。

推荐应用场景

用于后台管理和风控系统,获取网站历史快照的信息,在黑产应用领域取证使用

请求地址

https://api.f.360.cn/urls/std/internal/v2/snap_overview

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
keywordsArray(object)body是
[
  {
    "field": "domain",
    "value": "arthuajia.com"
  },
  {
    "field": "limit",
    "value": "10"
  }
]
查询条件,所有请求参数的子级结构
keywords.[0].fieldstringbody是domain查询条件的字段名,目前支持:url、cname、host、domain、ip、url_md5之一
keywords.[0].valuestringbody是arthuajia.com查询条件的字段值,由[0].field指定格式
keywords.[1].fieldstringbody是limit查询条件的字段名,只支持limit。用于限制返回数据的数量
keywords.[1].valueintegerbody否10查询条件的字段值,默认为10
queryobjectbody否
{
  "keywords": [
    {
      "field": "domain",
      "value": "arthuajia.com"
    },
    {
      "field": "limit",
      "value": "10"
    }
  ]
}
查询条件,所有请求参数的父级结构

响应参数

名称类型示例值描述
codestring0响应状态码
dataArray(object)
[
  {
    "source": "36",
    "parent_source": "",
    "url_md5": "692a3dff138ceed021993e0d84d68e34",
    "host": "wanghuan.arthuajia.com",
    "port": "80",
    "domain": "arthuajia.com",
    "cname": "",
    "final_url_md5": "",
    "final_url": "",
    "final_host": "",
    "final_port": "",
    "final_domain": "",
    "final_cname": "",
    "final_ip": "",
    "ip": "8.130.55.7",
    "url": "http://wanghuan.arthuajia.com",
    "check_time": "2023-11-02 11:08:31"
  }
]
响应具体信息
data.check_timestring2023-11-02 11:08:31快照生成/检测的时间
data.cnamestring原始URL的CNAME记录
data.domainstringarthuajia.com解析出的主域名
data.final_cnamestring最终请求的CNAME
data.final_domainstringarthuajia.com最终域名
data.final_hoststringwanghuan.arthuajia.com最终请求的主机名
data.final_ipstring8.130.55.7最终请求解析到的IP
data.final_portstring80最终请求的端口
data.final_urlstringhttp://wanghuan.arthuajia.com重定向后的最终落地URL
data.final_url_md5string692a3dff138ceed021993e0d84d68e34最终URL的MD5
data.hoststringwanghuan.arthuajia.com原始主机名
data.ipstring8.130.55.7原始URL解析到的IP地址
data.parent_sourcestring40上级来源
data.portstring80原始端口号
data.sourcestring36数据来源标识
data.urlstringhttp://wanghuan.arthuajia.com被查询的完整原始URL
data.url_md5string692a3dff138ceed021993e0d84d68e34该URL的MD5哈希值
msgstringok响应状态信息

请求示例

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

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

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/urls/std/internal/v2/snap_overview"
BODY='{"query":{"keywords":[{"field":"domain","value":"arthuajia.com"},{"field":"limit","value":"10"}]}}'

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",
    "msg": "ok",
    "data": [
        {
            "source": "36",
            "parent_source": "",
            "url_md5": "692a3dff138ceed021993e0d84d68e34",
            "host": "wanghuan.arthuajia.com",
            "port": "80",
            "domain": "arthuajia.com",
            "cname": "",
            "final_url_md5": "",
            "final_url": "",
            "final_host": "",
            "final_port": "",
            "final_domain": "",
            "final_cname": "",
            "final_ip": "",
            "ip": "8.130.55.7",
            "url": "http://wanghuan.arthuajia.com",
            "check_time": "2023-11-02 11:08:31"
        }
    ],
    "status": 0
}

业务异常响应

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