跳到正文

样本文件释放查询

接口说明

输入一个文件样本的 MD5 值(唯一标识),查询该样本在运行过程中 “释放 / 生成” 的其他文件(即 Dropped Files),最终返回这些释放文件的 MD5 值。这里的 “Dropped Files”(释放文件)是安全领域的常见概念:指某一个文件(如病毒、恶意程序)在执行时,主动向系统中释放、生成或解压出的额外文件(这些文件可能是辅助恶意行为的组件,如配置文件、子病毒程序、快捷方式等)。

请求地址

https://api.f.360.cn/files/std/internal/v2/dropped_files

请求方法

POST

请求参数

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

响应参数

名称类型示例值描述
codestring0响应状态码
dataArray(object)
data.drop_md5string818677da0b568bf1ede4e06af854c38f释放文件的hash的 MD5 值(释放文件的唯一标识)
msgStringOK响应状态信息
statusstring0目前无实际意义,默认为0

请求示例

支持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/v2/dropped_files"
BODY='{"query":{"keywords":[{"field":"md5","value":"000b11b2c7567d84c599de5b4d1f5681"}]}}'

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": [
        {
            "drop_md5": "d5afc3a476925ce740b7079d9bd2d269"
        },
        {
            "drop_md5": "cfc97f07904067a1e5fae195d534da3a"
        },
        {
            "drop_md5": "f3bdbe3bb6f734e357235f4d5898582d"
        },
        {
            "drop_md5": "cabb20e171770ff64614a54c1f31c033"
        },
        {
            "drop_md5": "8ae6dd9a6d246004da047f704f0cc487"
        },
        {
            "drop_md5": "403fd4023b3cdfd95fcbae0be3d39b92"
        },
        {
            "drop_md5": "1a67ca62e84f6742f6fe53dbecdf7510"
        },
        {
            "drop_md5": "dfd8d8d0ff28f17e42a0f19b40dc3966"
        }
    ],
    "msg": "ok",
    "status": 0
}

业务异常响应

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