跳到正文

手机文件安全信息云查服务

接口说明

通过手机apk文件sha1值,查询手机apk文件风险等级、木马名称、病毒类型、病毒行为、病毒描述等信息。 响应报文level级别描述说明:10 纯白 白名单收集,20 白 回扫或者其他方式确认为白的,30 灰白 杀软扫描没报的,40 灰 未知,50 低疑似 误报率高的,60 高疑似 误报率低的,70 杀软确认报是病毒或木马黑。注意最高level等级就是70! 一次最多查20个手机apk文件,超过部分无效,只查前20个。

请求报文格式示例:

{
  "data": [
    {
      "sha1": "37f3ee59b50e28e6e3bd4bc058c363ac9c047317",
      "exts": []
    }
  ],
  "exts": []
}

请求地址

https://api.f.360.cn/files/apk/v1/cloud_safe_info

请求方法

POST

请求参数

参数名类型位置是否必填示例值说明
dataArray(Object)body是查询的手机apk文件集合,单个请求最多携带20个apk文件,超过部分无效,只查前20个
data[].sha1stringbody是37f3ee59b50e28e6e3bd4bc058c363ac9c047317查询手机apk文件的sha1值
data[].extsArray(Object)body否当前手机apk文件扩展字段,可为空
data[].exts.keystringbody是当前手机apk文件扩展字段:字段名
data[].exts.valuestringbody是当前手机apk文件扩展字段:具体值
extsArray(Object)body否本次请求全局扩展字段,可为空
exts.keystringbody是本次请求全局扩展字段:字段名
exts.valuestringbody是本次请求全局扩展字段:具体值

参数请求示例

POST https://api.f.360.cn/files/apk/v1/cloud_safe_info

请求body:
{
    "data": [{
        "sha1": "37f3ee59b50e28e6e3bd4bc058c363ac9c047317",
        "exts": [{ // 查询手机apk文件的扩展字段,可为空
            "key": "key1",
            "value": "val1"
        }]
    }, {
        "sha1": "c44f8bacb905cf3deec0104ed8beef1a9298346b",
        "exts": [{ // 查询手机apk文件的扩展字段,可为空
            "key": "key1",
            "value": "val1"
        }]
    }],
    "exts": [{ // 本次请求全局扩展字段,可为空
        "key": "global_key1",
        "value": "global_val1"
        }
        // more ext
    ]
}

响应参数

名称字段类型是否必填示例值描述
codestring是0响应状态码,0为正常
msgstring是success响应状态信息,success为正常
dataobject是-手机apk文件查询结果
data.resultsArray(object)是-响应的手机apk文件集合
data.results.sha1string是37f3ee59b50e28e6e3bd4bc058c363ac9c047317响应手机apk文件的sha1值
data.results.infoobject是-响应手机apk文件的详细信息
data.results.info.behavior_descArray(string)否强制开机自启动风险行为描述集合
data.results.info.descstring否该软件涉嫌存在危险行为代码,可能给您造成不必要的损失。手机apk文件行为描述
data.results.info.levelnumber是70响应的手机apk文件风险级别,level级别描述说明:10 纯白 白名单收集,20 白 回扫或者其他方式确认为白的,30 灰白 杀软扫描没报的,40 灰 未知,50 低疑似 误报率高的,60 高疑似 误报率低的,70 杀软确认报是病毒或木马黑。注意最高level等级就是70!
data.results.info.malwarestring否Backdoor.RAT.Android.FinSpy.B表示木马或病毒原始英文名
data.results.info.extsArray(object)否-响应手机apk文件的扩展字段,可为空
data.results.info.exts.keystring否-响应手机apk文件的扩展字段:字段名
data.results.info.exts.valuestring否-响应手机apk文件的扩展字段:具体值
data.extsArray(object)否-本次响应全局扩展字段,可为空
data.exts.keystring否-本次响应全局扩展字段:字段名
data.exts.valuestring否-本次响应全局扩展字段:具体值

请求示例

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

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

APPID=""  # apikey
SECRET=""  # salt
URL="https://api.f.360.cn/files/apk/v1/cloud_safe_info"
BODY='{"data":[{"sha1":"37f3ee59b50e28e6e3bd4bc058c363ac9c047317"},{"sha1":"c44f8bacb905cf3deec0104ed8beef1a9298346b"}]}'

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": "success",
    "data": {
        "results": [
            {
                "sha1": "37f3ee59b50e28e6e3bd4bc058c363ac9c047317",
                "info": {
                    "behavior_desc": [
                        "强制开机自启动",
                        "私自发短信",
                        "盗取用户信息",
                        "使用有风险权限",
                        "使用不符的风险权限"
                    ],
                    "desc": "该软件涉嫌存在危险行为代码,可能给您造成不必要的损失。",
                    "exts": [],
                    "level": 70,
                    "malware": "Backdoor.RAT.Android.FinSpy.B"
                }
            },
            {
                "sha1": "c44f8bacb905cf3deec0104ed8beef1a9298346b",
                "info": {
                    "behavior_desc": [
                        "使用有风险权限"
                    ],
                    "desc": "该软件存在风险内容,可能给您的财产或账户造成不必要的损失,请使用前仔细甄别。",
                    "exts": [],
                    "level": 50
                }
            }
        ],
        "exts": []
    }
}

业务异常响应

{
    "code": "AB13201",
    "msg": "服务端内部错误,响应内容为空"
}