网关统一认证
请求地址
https://update.ti.360.cn/api/v2/list
通信协议
所有接口均通过 HTTPS 协议进行通信,提供高安全的通信通道。
认证方式
情报订阅API网关采用统一标准的认证方式,具体的请求认证参数见下表:
| 参数名 | 类型 | 是否必填 | 参数位置 | 说明 |
|---|---|---|---|---|
| timestamp | string | 是 | Header | 设备当前 Unix 时间戳(秒);与云端时间相差 ≥ 86400 秒时返回错误 |
| key | string | 是 | Header | 情报中心为每台设备颁发的密钥,与 salt 成对出现 |
| sign | string | 是 | Header | 签名值,生成规则:sign = md5($type$timestamp$salt) |
| lid | string | 是 | Header | 证书唯一 ID;未接入 EPP 证书系统时可传自有证书 ID,需服务端开启对应查询 API |
| type | string | 是 | Body | 查询的子类型,由情报中心统一颁发 |
响应状态码
| 状态码 | 描述 | 说明 |
|---|---|---|
| 4002 | error sign | 签名错误 |
| 4003 | certificate illegal! | 证书不可用 |
| 4005 | Param key error | header 中参数错误 |
| 4005 | Api key permission denied | apikey 没有权限 |
| 4005 | lid/sn validate error | lid/sn 错误 |
| 4005 | Not founded key: XXXX | 请求中缺少参数 XXXXX |
| 4005 | error value:XXXXX | 请求中参数 XXXX 错误 |
| 4006 | XXXXXXX | 服务器未能解析该请求的其他错误 |
| 4007 | Timestamp error | 请求中的时间戳与服务器时间不同步(超出 3 小时以 上) |
| 4009 | XXXXXXX | 服务器发生错误 |
| 4012 | Interface request transfinite | apikey 超过当天最大请求数 |