跳到正文

IP高级分析接口

接口说明

IP 高级分析接口用于聚合查询指定 IP 的多维情报信息,包括风险摘要、威胁标签、反向 DNS、IP WHOIS、Quake 资产、TLS 证书、关联样本和公开报告。

请求地址

https://api.f.360.cn/advanced/ip

请求方法

POST

请求参数

参数名类型位置必选示例值说明
valuestringBody是172.96.136.31需要查询的 IPv4/IPv6 地址

响应参数

基础响应字段

参数名类型说明
codeint响应状态码,200 表示成功
messagestring响应消息
data.resultobjectIP 高级分析结果
metaobject / null扩展元信息

data.result 字段

参数名类型说明
ipstring查询的 IP 地址
summaryobjectIP 风险摘要、归属地和网络画像信息
tag_listlistIP 标签列表;为空时返回空列表
rdnslist反向 DNS 解析记录列表
ip_whoisobjectIP WHOIS 信息;无数据时字段值可能为空字符串或 null
quakelistQuake IP 资产服务信息,最多返回 20 条
certlistTLS/SSL 证书列表;无数据时返回空列表
sampleslist关联通信样本摘要,最多返回 10 条
reportslist关联公开报告列表;无数据时返回空列表

summary 字段

参数名类型说明
confidencestring / null置信度,例如 unknown
riskstring / null风险等级,例如 unknown、safe、low
geo_infoobject地理位置和网络归属摘要,常见字段包含 province、city、country、asn、as、operator
block_impactint / float / null封禁影响评估数值;例如 -1 表示未知或未评估
user_typestring用户或资产类型,可能为空字符串
threat_typelist威胁类型列表;为空时返回空列表
anonymous_typestring匿名代理类型,可能为空字符串
network_typelist网络类型列表,例如 Used
honeypot_hitbool / null是否命中蜜罐

rdns 字段

参数名类型说明
time_firstint / string首次发现时间,实际返回可能为 Unix 时间戳
time_lastint / string最近发现时间,实际返回可能为 Unix 时间戳
rrnamestring解析域名
rrtypestringDNS 记录类型,例如 A、AAAA
rdatastring记录值,通常为查询 IP
countint命中次数

ip_whois 字段

参数名类型说明
inetnumstringIP 段或网络编号
serverstringWHOIS 服务
net_typestring网络分配类型
net_namestring网络名称
parent_netstring父级网络
sourcestringWHOIS 来源,可能为空字符串
end_ipstring结束 IP
org_namestring所属组织,可能为空字符串
last_modifiedstring最后更新时间
countrystring国家/地区代码,可能为空字符串
object_class_namestringWHOIS 对象类型
ip_versionstringIP 版本,例如 v4
statusstring / null分配状态,例如 active

quake 字段

参数名类型说明
domainstring / null资产关联域名,可能为 null
ipstring资产 IP
asnint / string / nullASN
transportstring传输协议
portint端口
timestring资产记录时间
hostnamestring主机名,可能为空字符串
orgstring组织
serviceobject服务信息,当前包含 name
componentslist组件信息列表;每项包含产品层级、类型、厂商、中文/英文产品名、产品目录、版本等
locationobjectQuake 地理位置和场景信息,包含中英文国家/省市、country_code、asname、isp、gps、scene 等

cert 字段

参数名类型说明
subject_CNstring证书主体 CN
subjectstring证书主体
issuerstring证书签发者
validity_statusstring证书有效性状态
trusted_statusstring证书信任状态
startstring证书生效时间
endstring证书过期时间
SANlist证书备用名称列表
sourceslist证书来源列表
endpointslist观测到的 IP:端口列表
md5string证书 MD5 指纹
sha1string证书 SHA1 指纹
sha256string证书 SHA256 指纹

samples 字段

参数名类型说明
file_namestring样本文件名,可能为空字符串
file_sizeint / string样本大小(Byte);未知时可能为空字符串
file_typestring文件类型
md5stringMD5
sha1stringSHA1
sha256stringSHA256
first_timestring首次发现时间
levelstring / null样本风险等级,例如 safe、unknown
virus_namestring / null病毒名

reports 字段

参数名类型说明
titlestring报告标题
authorstring报告作者
tagslist报告标签
urlstring报告链接
update_timestring报告更新时间

请求示例

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

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

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/advanced/ip"
BODY='{"value":"172.96.136.31"}'

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": 200,
  "message": "Success",
  "data": {
    "result": {
      "ip": "172.96.136.31",
      "summary": {
        "confidence": "unknown",
        "risk": "unknown",
        "geo_info": {
          "province": "Texas",
          "city": "Dallas",
          "country": "United States",
          "asn": 395092,
          "as": "SHOCK-1",
          "operator": "Shock Hosting LLC"
        },
        "block_impact": -1,
        "user_type": "",
        "threat_type": [],
        "anonymous_type": "",
        "network_type": [
          "Used"
        ],
        "honeypot_hit": false
      },
      "tag_list": [],
      "rdns": [
        {
          "time_first": 1776468829,
          "time_last": 1777497061,
          "rrname": "gidosdelicacy.com",
          "rrtype": "A",
          "rdata": "172.96.136.31",
          "count": 25
        }
      ],
      "ip_whois": {
        "inetnum": "NET-172-96-136-0-1",
        "server": "whois.arin.net",
        "net_type": "DIRECT ALLOCATION",
        "net_name": "SH-335",
        "parent_net": "NET-172-0-0-0-0",
        "source": "",
        "end_ip": "172.96.139.255",
        "org_name": "",
        "last_modified": "2017-10-17T15:55:22-04:00",
        "country": "",
        "object_class_name": "ip network",
        "ip_version": "v4",
        "status": "active"
      },
      "quake": [
        {
          "domain": null,
          "ip": "172.96.136.31",
          "asn": 395092,
          "transport": "tcp",
          "port": 995,
          "time": "2026-04-28T16:54:51.080Z",
          "hostname": "tx-s1.serverpanel.com",
          "org": "Shock Hosting LLC",
          "service": {
            "name": "pop3/ssl"
          },
          "location": {
            "country_en": "United States",
            "country_cn": "美国",
            "country_code": "US",
            "province_en": "Texas",
            "city_en": "Dallas",
            "isp": "Shock Hosting LLC",
            "asname": "SHOCK-1",
            "scene_en": "Used",
            "gps": [
              -96.795894,
              32.781745
            ]
          }
        }
      ],
      "cert": [],
      "samples": [
        {
          "file_name": "",
          "file_size": 6261616,
          "file_type": "pe_exe_x86",
          "md5": "78fc0052d63a8b68d7000f47f9aa81d8",
          "sha1": "9567f025a68eff7d22503a98101177505ea26fef",
          "sha256": "950e4bcf1841481b53e2c8c7774be2f1a09c20be5f8aedceb8ac65b05d6cbb70",
          "first_time": "2019-06-24 00:00:00",
          "level": "safe",
          "virus_name": null
        }
      ],
      "reports": []
    }
  },
  "meta": null
}