批量订阅卡板信息(100张)

批量订阅/取消订阅卡板信息，单次最多100张。

数据推送条件

对接方成功订阅卡板信息，且在我方平台轮询检测到卡板数据变动时(流量、卡板状态、实名/激活状态等一系列需要营运关注的数据变动)，会为对接方主动推送最新的卡板数据。我方平均每小时更新一次数据。

数据结构

订阅推送数据和批量查询卡板信息接口响应参数完全一致，并且请求头中使用了和请求接口签名一致的签名参数和算法，可用于验证签名以确保订单参数的安全性。

回复确认

对接方收到推送数据并回调成功后，请回复HTTP状态码：200，否则我方将视为推送失败，并在后续的一段时间内重试推送。

重试规则

推送失败后，我方最大重试推送2次，共计3次。分别是在首次推送失败后的第30分钟、第2小时，超过2次后将不再推送。若后续对接方仍想获取到最新的订单数据可登录我方代理商后台找到需要推送的卡板-【操作】-【数据推送】-【立即推送】；亦或是通过批量查询卡板信息接口进行主动拉取

请求参数

Body 参数application/x-www-form-urlencoded

simNos

string

必需

卡板卡号，单次最多允许100个

示例值:

["19287697294","19287697293","19287697292","19287697291","19287697290"]

updateStatus

string

必需

变更状态，1订阅消息，2取消订阅

示例值:

subscribeUrl

string

订阅地址

可选

示例值:

https://www.baidu.com

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

0成功，其他失败

必需

message

string

状态码描述

必需

data

object

数据集

必需

items

array [object {25}]

必需

timestamp

integer

必需

traceID

string

必需

示例

{
  "code": 0,
  "message": "操作成功",
  "data": {
    "items": [
      {
        "gatewayId": 4,
        "packageGroupId": 7,
        "poolId": 0,
        "simNo": "19287697291",
        "iccid": "89861500192430509496",
        "imsi": "",
        "imei": "",
        "simStatus": 9999,
        "activateStatus": 1,
        "authStatus": 1,
        "authPlatformStatus": 1,
        "internetStatus": 1,
        "onlineStatus": 3,
        "cancelStatus": 1,
        "replaceStatus": 1,
        "robinStatus": 1,
        "activateAt": null,
        "authAt": null,
        "authPlatformAt": null,
        "rechargeTimes": 0,
        "totalFlow": 0,
        "useFlow": 0,
        "endAt": null,
        "lastRobinAt": "2024-11-14 23:26:44",
        "lastSimStatusAt": "2024-11-14 23:26:44"
      },
      {
        "gatewayId": 4,
        "packageGroupId": 7,
        "poolId": 0,
        "simNo": "19287697292",
        "iccid": "89861500192430509497",
        "imsi": "",
        "imei": "",
        "simStatus": 9999,
        "activateStatus": 1,
        "authStatus": 1,
        "authPlatformStatus": 1,
        "internetStatus": 1,
        "onlineStatus": 3,
        "cancelStatus": 1,
        "replaceStatus": 1,
        "robinStatus": 1,
        "activateAt": null,
        "authAt": null,
        "authPlatformAt": null,
        "rechargeTimes": 0,
        "totalFlow": 0,
        "useFlow": 0,
        "endAt": null,
        "lastRobinAt": "2024-11-14 23:26:45",
        "lastSimStatusAt": "2024-11-14 23:26:44"
      },
      {
        "gatewayId": 4,
        "packageGroupId": 7,
        "poolId": 0,
        "simNo": "19287697293",
        "iccid": "89861500192430509498",
        "imsi": "",
        "imei": "",
        "simStatus": 9999,
        "activateStatus": 1,
        "authStatus": 1,
        "authPlatformStatus": 1,
        "internetStatus": 1,
        "onlineStatus": 3,
        "cancelStatus": 1,
        "replaceStatus": 1,
        "robinStatus": 1,
        "activateAt": null,
        "authAt": null,
        "authPlatformAt": null,
        "rechargeTimes": 0,
        "totalFlow": 0,
        "useFlow": 0,
        "endAt": null,
        "lastRobinAt": "2024-11-14 23:26:45",
        "lastSimStatusAt": "2024-11-14 23:26:44"
      },
      {
        "gatewayId": 4,
        "packageGroupId": 7,
        "poolId": 0,
        "simNo": "19287697294",
        "iccid": "89861500192430509499",
        "imsi": "",
        "imei": "",
        "simStatus": 9999,
        "activateStatus": 1,
        "authStatus": 1,
        "authPlatformStatus": 1,
        "internetStatus": 1,
        "onlineStatus": 3,
        "cancelStatus": 1,
        "replaceStatus": 1,
        "robinStatus": 1,
        "activateAt": null,
        "authAt": null,
        "authPlatformAt": null,
        "rechargeTimes": 4,
        "totalFlow": 20971520,
        "useFlow": 0,
        "endAt": "2024-11-09 00:00:00",
        "lastRobinAt": "2024-11-14 23:26:46",
        "lastSimStatusAt": "2024-11-14 23:26:44"
      }
    ]
  },
  "timestamp": 1731665385,
  "traceID": "5831f960804c9217ec01e425b8cc76f5"
}

数据推送条件#

数据结构#

回复确认#

重试规则#

请求参数

示例代码

返回响应

数据推送条件

数据结构

回复确认

重试规则