消息推送

签名

为了接收方能对API消息来源进行验证，推送消息的header中加入了x-lf-md5参数，注意算法如下：
在header增加MD5参数
x-lf-md5 : base64(MD5("key1=value1&key2=value2&secret))
(key, value)为body中的参数，计算时按字典序排列
类型1：{}对象按自然排序key1=value1&key2=value2&secret,
类型2： [] 中每个对象中成员按自然排序，对象间按list顺序拼接 key1=value1&key2=value2&key1=value11&key2=value22&secret
（secret与调用领科API时的密钥不一致，请单独联系领科人员获取）

推送消息类型

当前系统定义了如下事件类型并提供API推送

warningCode	业务描述	推送频率
1	未购买套餐：首单已启用但无其他订单的设备信息，进行推送。数据推送为量全推送，即一台设备数据可能推送多次。同一次推送中，同一张卡不会重复出现。但若卡片一直未购买，则可能会每周推送一次。	固定周期，北京时间每周二上午9点
2	套餐到期不足7天：查询时间与订单到期时间差值为小于7天的设备信息。同一张卡快到期又购买了新套餐不会推送	固定周期，北京时间每周二上午9点
3	套餐已过期：设备无未启用订单，且使用中的订单（非首单）状态变更为已结束。结束时间距离当前时间超过7天的也会包含在推送范围内。	固定周期，北京时间每周二上午9点
-1	购买套餐成功	实时触发，用户套餐订购成功

请求参数

Header 参数

x-lf-md5

string

可选

base64(MD5("key1=value1&key2=value2&secret))

x-lf-delivery

string

可选

unique id (snowflake)

Body 参数application/json

devices

array [object {3}]

必需

expireTime

string

套餐订单过期时间

可选

warningCode

string

必需

编码 1无购买套餐 2即将到期 3已到期 4体验套餐流量耗尽（仅部分资源支撑）-1已购买

deviceId

string

SIM卡ICCID

必需

示例

{
  "devices": [
    {
      "expireTime": "",
      "warningCode": "1",
      "deviceId": "89314404000816575667"
    },
    {
      "expireTime": "",
      "warningCode": "1",
      "deviceId": "89314404000816575667"
    },
    {
      "expireTime": "",
      "warningCode": "1",
      "deviceId": "89314404000816575667"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

签名#

推送消息类型#

请求参数

示例代码

返回响应

签名

推送消息类型