跳到正文

样本基础综合信息查询

接口说明

对样本的综合信息进行批量查询(单次最多 20 条),支持输入 md5,sha1,sha256 多种格式,返回信誉值、病毒名称、标签、流行度、文件类型、文件名称、文件大小、pv、最近扫描时间、发现时间、结束时间、信誉数值和信誉度(相比 查询-样本-情报标签 接口,增加了流行度、文件类型、文件名称、文件大小、pv、最近扫描时间、发现时间、结束时间、信誉数值和信誉度)。

请求地址

https://api.f.360.cn/files/std/internal/v5/intelligence/l2

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
queryArray(String)body是
[
  "1eb5989b5b354cf88c38f835d4b68642"
]
md5、sha1 或 sha256 组成的集合,长度不超过20个元素
sourceStringbody是hm请求来源(自定义,如 项目缩写)

响应参数

名称类型示例值描述
codestring0响应状态码
msgstringok响应状态信息
dataArray
[]
包含多个结果
data.confidenceInt0云查信誉度
data.file_namestringATI2EVXX.EXE文件名称
data.file_sizeInt692224文件大小
data.file_typestringpe_exe_x86文件类型
data.first_timeInt1618661616发现时间
data.last_scan_timeInt1618661616最近扫描时间
data.last_timeInt1754017881更新时间 (IOC更新时间)
data.levelstring危险样本信誉值(危险,未知,普通,安全)
data.level_valueInt0云查信誉数值
data.malwarestringWin32/Trojan.Dorv.HxMBEpsA病毒名称(自定义)
data.md5string1eb5989b5b354cf88c38f835d4b68642查询样本的md5
data.popularitystring1流行度,见表流行度枚举
data.pvInt0pv访问量
data.sha1stringce59ae868e251a54d9033e18dffe171251857c20查询样本的sha1
data.sha256string217b758f8e0ca26cead270ca7a47956c5cf5dd4d1463c4826d3fd4fc9d6dece8查询样本的sha256
data.statusStringACTIVE标签状态:ACTIVE:活跃,OVER:过期,UNKNOWN:未知,Sinkhole:被处置
data.tagsArray包含多个标签
data.tags.aliasArray
[]
标签别名
data.tags.descString云端规则参与研判标签描述
data.tags.expire_timeInt1754017881标签过期时间
data.tags.focus_onArray
[
  0
]
特殊关注节点(1001 APT,1002 挖矿,1003 勒索,1004 僵尸,1005 后门,0默认值)
data.tags.idString标签id(待补充)
data.tags.nameString云识别标签名称
data.tags.sourceInt101来源
data.tags.source_nameString情报IOC来源含义
data.tags.typeInt1类型(1恶意威胁,2危险威胁,3风险内容,4常规属性,5正常服务)
data.tags.update_timeInt1741190400标签更新时间
imphashstring12fcdccc0a959fa3a11a8820a1c4bb23PE文件导入表的hash值
ssdeepstringPmqCpw3TdOVbwPylqidX9epcB5fSwrU92F6FN模糊哈希实现

请求示例

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

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

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/files/std/internal/v5/intelligence/l2"
BODY='{"query":["1eb5989b5b354cf88c38f835d4b68642"],"source":"hm"}'

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": "ok",
  "request_id": "VfcUCTxcpyIMzLbuNPsC",
  "data": [
    {
      "md5": "fdadd6050aec5f744d8e4e7118f95fc6",
      "sha1": "4d002443ed7fac02b1731ee625b399e60229de3f",
      "sha256": "78bd96c614349f2ec4029db543731097833727954babd50ccd6ef955cb13bba9",
      "level": "危险",
      "malware": "Linux/Backdoor.Mirai.Hq8ASqQA",
      "status": "ACTIVE",
      "tags": [
        {
          "id": "",
          "name": "Linux/Backdoor.Mirai.Hq8ASqQA",
          "desc": "",
          "alias": [],
          "update_time": 0,
          "expire_time": 0,
          "source": 101,
          "source_name": "情报IOC",
          "type": 1,
          "focus_on": [
            0
          ]
        },
        {
          "id": "",
          "name": "Mirai",
          "desc": "",
          "alias": [],
          "update_time": 0,
          "expire_time": 0,
          "source": 101,
          "source_name": "情报IOC",
          "type": 1,
          "focus_on": [
            0
          ]
        },
        {
          "id": "",
          "name": "具有木马特征程序",
          "desc": "",
          "alias": [],
          "update_time": 0,
          "expire_time": 0,
          "source": 101,
          "source_name": "情报IOC",
          "type": 1,
          "focus_on": [
            0
          ]
        },
        {
          "id": "",
          "name": "Backdoor",
          "desc": "远控木马",
          "alias": [],
          "update_time": 0,
          "expire_time": 0,
          "source": 101,
          "source_name": "情报IOC",
          "type": 1,
          "focus_on": [
            0
          ]
        }
      ],
      "popularity": "1",
      "file_type": "shell",
      "file_name": "",
      "file_size": 1900,
      "first_time": 1650758751,
      "last_time": 0,
      "pv": 193,
      "last_scan_time": 1653134262,
      "level_value": 70,
      "confidence": 60
    }
  ]
}

业务异常响应

{
  "code": "AC150100",
  "msg": "参数有误",
  "request_id": "OtkkoOOtCNswmEdpLlgU",
  "data": {}
}