Linksfield Developer
OverviewCube APIsOld version
OverviewCube APIsOld version
  1. Notification
  • CSSS APIs
    • Overview
    • Internationalization
    • Status code
    • Sign code Example
    • SIM
      • Get all SIM cards info
      • Get real-time info about one SIM card
      • Get the SIM Cards in use
    • Usage
      • Example Query the traffic usage of a single SIM card
      • Batch querying SIM card usage
      • Example Query the daily usage
      • Batch querying the usage in a specified month
    • Plan
      • Get data plan
      • Order data plan
      • Bulk order package
      • Renew your data plan
      • Query the package order information
      • To enable the order
      • Cancel an unenabled package order
      • End package orders early
      • [不推荐]停机/暂停流量套餐订单
      • [不推荐]复机/重新启动流量套餐订单
      • 【不推荐】分页批量(查询)同步设备可订购套餐
    • SMS
      • Send SMS
    • Customized
      • Order OTA Plan
      • Query the remaing data by MNO side
  • Notification
    • Notification Overview
    • Notification status code
    • 流量使用量API预警
      POST
    • 短信下行回调
      POST
    • 短信上行回调
      POST
    • 短信上行回调(区分文本二进制)
      POST
    • Plan Order Status Change notification (IMSI)
      POST
  • Mall APIs
    • Mall全局说明
    • Mall业务流程
    • Mall签名代码示例
    • APP调用Stripe的SDK示例说明
    • Vshop
      • 卡片登录验证
      • 获取可购套餐商品列表
      • 创建用户订单
      • 查询自动续费记录
      • 关闭自动续费
      • 查询正在使用、未启用订单
      • 获取生效中的自动续费
      • 关闭自动续费
      • 用户下单(第三方支付)
    • Payment
      • 获取stripe单次支付权限
      • 获取Stripe订阅支付权限
      • 创建Stripe订阅/自动续费
      • 支付结果查询
      • 支付结果确认
    • Notification
      • 消息推送
        POST
  • eSIM QR Mall APIs
    • Introduction
    • Pre - order
      POST
    • v1.1/payment/webhook
      POST
    • User login
      POST
    • My eSIM Detail
      POST
    • Pre - order v1.2
      POST
  1. Notification

消息推送

Developing
Demo UAT
http://127.0.0.1
Demo UAT
http://127.0.0.1
POST
客户自定义的URL

签名#

在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时的密钥不一致,请单独联系领科人员获取)

1.用户未购买套餐#

规则:每7天为周期对订单数据进行查询,获取到首单已启用但无其他订单的设备信息,进行推送。数据推送为量全推送,即一台设备数据可能推送多次。同一次推送中,同一张卡不会重复出现。但若卡片一直未购买,则可能会每周推送一次。
可将没有进行新订购行为的设备进行筛选,并推送至客户。

2.购买套餐即将到期,距到期日期不足7天#

规则:每7天为周期对订单数据进行查询,获取到查询时间与订单到期时间差值为小于7天的设备信息。同一张卡快到期又购买了新套餐不会推送。

3.购买套餐已过期#

每7天为周期对订单数据进行查询,设备无未启用订单,且使用中的订单(非首单)状态变更为已结束。结束时间距离当前时间超过7天的也会包含在推送范围内。
请求时间:北京时间每周二上午9点

Request

Header Params
x-lf-md5
string 
optional
base64(MD5("key1=value1&key2=value2&secret))
x-lf-delivery
string 
optional
unique id (snowflake)
Body Params application/json
devices
array [object {3}] 
required
expireTime
string 
optional
套餐订单过期时间
warningCode
string 
required
编码 1无购买套餐 2即将到期 3已到期 4体验套餐流量耗尽(仅部分资源支撑)
deviceId
string 
required
SIM卡ICCID
Example
{
    "devices": [
        {
            "expireTime": "",
            "warningCode": "1",
            "deviceId": "89314404000816575667"
        },
         {
            "expireTime": "",
            "warningCode": "1",
            "deviceId": "89314404000816575667"
        },
         {
            "expireTime": "",
            "warningCode": "1",
            "deviceId": "89314404000816575667"
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1客户自定义的URL' \
--header 'Content-Type: application/json' \
--data-raw '{
    "devices": [
        {
            "expireTime": "",
            "warningCode": "1",
            "deviceId": "89314404000816575667"
        },
         {
            "expireTime": "",
            "warningCode": "1",
            "deviceId": "89314404000816575667"
        },
         {
            "expireTime": "",
            "warningCode": "1",
            "deviceId": "89314404000816575667"
        }
    ]
}'

Responses

🟢200成功
application/json
Body
code
string 
required
0-成功,非0-失败
message
string 
required
Example
{
    "code": "string",
    "message": "string"
}
Modified at 2022-10-04 23:23:51
Previous
支付结果确认
Next
Introduction
Built with