批量订阅卡板信息(100张)
POST
/openapi/iot/batchSubscribe批量订阅/取消订阅卡板信息,单次最多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取消订阅
示例值:
2
subscribeUrl
string
订阅地址
示例值:
https://www.baidu.com
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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"
}
最后修改时间: 3 个月前