688号卡 - 开放接口 V2.0
  1. 物联卡业务
688号卡 - 开放接口 V2.0
  • 对接前必看
  • 号卡/宽带业务
    • 号卡订单状态码说明
    • 关于下单省市区编码
    • 获取店铺基础配置
      GET
    • 获取在售商品列表
      POST
    • 发送短信验证码
      POST
    • 预选下单号码
      POST
    • 提交申请订单
      POST
    • 订单查询
      POST
    • 获取指定商品详细信息
      POST
    • 上传证件照
      POST
    • 订单回调
      POST
    • IP定位
      GET
  • 靓号业务
    • 获取靓号列表
  • 物联卡业务
    • 物联卡相关状态码说明
    • 批量查询卡板信息(100张)
      POST
    • 批量订阅卡板信息(100张)
      POST
    • 批量查询卡板最新状态(10张)
      POST
    • 批量查询卡板实时流量(10张)
      POST
    • 批量查询卡板指定月流量(10张)
      POST
    • 批量停机(100张)
      POST
    • 批量复机(100张)
      POST
    • 单卡机卡绑定
      POST
    • 单卡限速
      POST
    • 单卡解除限速
      POST
    • 单卡订购套餐包
      POST
    • 获取官方实名链接
      POST
    • 查询卡板操作记录
      POST
    • 查询账户资产
      POST
    • 获取移动流量池Token
      POST
  1. 物联卡业务

批量查询卡板信息(100张)

POST
/openapi/iot/batchQuerySimInfo
批量查询卡板信息，单次最多100张。
该接口非实时接口，我方平均每小时更新一次数据。
若需最新卡板信息可通过调用接口批量查询卡板最新状态和批量查询卡板实时流量来提前更新

请求参数

Body 参数application/x-www-form-urlencoded
simNos
string 
必需
卡板卡号，单次最多允许100个
示例值:
["1064010422716"]

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/openapi/iot/batchQuerySimInfo' \
--data-urlencode 'simNos=["1064010422716"]'

返回响应

🟢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"
}
修改于 2025-01-02 07:56:01
上一页
物联卡相关状态码说明
下一页
批量订阅卡板信息(100张)
Built with