跳到正文

IP云查鉴定查询

接口说明

该接口支持通过指定的客户端 IP 地址,查询与该 IP 相关联的、曾被上传或进行过云查(云端安全检测)的文件样本对应的 MD5 哈希值列表,为追溯特定 IP 的文件操作轨迹、安全审计等场景提供数据支持。返回的MD5哈希值列表按照ip进行去重处理,每个ip最多保留200个样本文件md5。

请求地址

https://api.f.360.cn/ips/std/internal/v2/cloud_judge

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
queryobjectbody是
{
  "keywords": [
    {
      "field": "ip",
      "value": "1.1.129.213"
    }
  ]
}
查询条件,所有请求参数的父级结构
query.keywordsArray(object)body是
[
  {
    "field": "ip",
    "value": "1.1.129.213"
  }
]
查询条件,所有请求参数的子级结构
query.keywords.fieldstringbody是ip查询条件的字段名,支持的字段有:ip
query.keywords.valuestringbody是1.1.129.213查询条件的字段值,为单个ip

响应参数

名称类型示例值描述
codestring0响应状态码
dataArray(object)
[
  {
    "md5": "d7bfd86f7a9abe39351199869d093110"
  }
]
响应具体信息
data.md5Stringd7bfd86f7a9abe39351199869d09311032位的文件样本hash
msgstringok响应状态信息

请求示例

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

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

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/ips/std/internal/v2/cloud_judge"
BODY='{"query":{"keywords":[{"field":"ip","value":"1.1.129.213"}]}}'

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": [
        {
            "md5": "541b435cdf7e6ea71b8f686929300b9c"
        },
        {
            "md5": "a04ff9ec80ddae1cbb5fdf587739fdc9"
        },
        {
            "md5": "154efc7cbd8fdf73cffeb35b6d9fbd8b"
        },
        {
            "md5": "b7bca97337d461df6c71319b59139150"
        },
        {
            "md5": "edf75d3f3b797cf0063e680b79295eea"
        },
        {
            "md5": "3d03d838f583950384c2e18d04c58255"
        },
        {
            "md5": "f16f8fe66e34dc45ee72dbb183be0e53"
        }
    ],
    "msg": "ok",
    "status": 0
}

业务异常响应

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