跳到正文

获取数据包接口

请求地址

https://update.ti.360.cn/api/v2/list

请求方法

POST

请求参数

参数名类型是否必填参数位置说明
timestampstring是Header获取的设备上的当前时间戳,单位是秒。当设备上的timestamp与云端相差3600*24时,API返回出错
keystring是Header由情报中心端颁发每台设备都会成对的颁发 key : salt
signstring是Headerheader 参数, sign = md5($type$timestamp$salt)
lidstring是Headerheader 参数,能标识证书唯一性的ID。
typestring是Bodybody 要查询的子类型。目前支持的类型有:ti_data:IOC
package_typestring否Bodybody需要查询的升级包类型。默认是 ti_data
versionstring否Bodybody当前设备上的 ioc 情报的版本
datalist是Bodybody默认传[]

响应参数

参数类型说明
codeint结果状态,2000 表示成功,其它表示出错
messagestring对 code 的解释
expire_timeint客户订阅的过期时间,单位是秒
datalist结果数据,每个升级包为一个元素;如果证书已过期,则 data 为空;

data中的每个元素的字段如下:

  • type: string 升级包类型
  • sub_type: string 子类型, all = 全量;increment=增量
  • package_type: string ti_data 数据升级包
  • name: string 升级包名称
  • version : string 升级包版本
  • size: int, 文件大小
  • publish_time: int, 单位是秒, 升级包发布时间
  • sha256: string 升级包的 sha256, 供校验升级包的完整性
  • download_url: string 升级包的 S3 下载地址, 15 分钟内有效, 超过 15 分钟链接失效

请求示例

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

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

KEY=""    # 设备 key
SALT=""   # 设备 salt
LID=""    # 证书唯一 ID
TYPE="ti_data:IOC"
URL="https://update.ti.360.net/api/v2/list"
BODY='{"type":"ti_data:IOC","version":"","data":[],"starttime":""}'

TIMESTAMP=$(date +%s)
SIGN=$(printf '%s' "${TYPE}${TIMESTAMP}${SALT}" | openssl dgst -md5 -hex | awk '{print $NF}')

curl --location --request POST "$URL" \
  --header "Content-Type: application/json" \
  --header "key: ${KEY}" \
  --header "lid: ${LID}" \
  --header "timestamp: ${TIMESTAMP}" \
  --header "sign: ${SIGN}" \
  --data "${BODY}"

响应示例

{
    "expire_time": 1791820799,
    "message": "OK",
    "code": 2000,
    "data": [
        {
            "publish_time": 1764275107,
            "name": "IOC_all_v3.1.20251128.1.tar.gz",
            "total_count": 6000001,
            "package_type": "ti_data",
            "download_url": "https://cn-zhengzhou-1.xstore.qihu.com/ioc-sdk-3g-plain/IOC_all_v3.1.20251128.1.tar.gz?response-content-disposition=attachment%3B%20filename%20%3D%20IOC_all_v3.1.20251128.1.477b2a70775d0991fef45bef3a20318d.tar.gz&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=VQR0WYKYCUGMPSO4CRVD%2F20251129%2Fsh-bt-1%2Fs3%2Faws4_request&X-Amz-Date=20251129T091113Z&X-Amz-Expires=21600&X-Amz-SignedHeaders=host&X-Amz-Signature=b662d1db1b710a9fe3762d87e3ff057df61fb628f4b6a792b0d309fb51cf060d",
            "version": "v3.1.20251128.1",
            "sha256": "39de3e3325442bfd431c2e472159a983426fafb169aed67a9cbe6037ae86338b",
            "type": "IOC_SDK_3G_PLAIN",
            "sub_type": "all",
            "size": 146113824
        }
    ]
}