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

查询设备流量

POST
/openapi/iot/queryDeviceFlow
查询设备流量。
该接口和查询设备信息接口返回数据一致,但流量刷新会更及时,成功率也更高

请求参数

Header 参数

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

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1:2000/openapi/iot/queryDeviceFlow' \
--header 'appID;' \
--header 'apiVersion;' \
--header 'traceID;' \
--header 'timestamp;' \
--header 'sign;' \
--data-urlencode 'deviceNo=9176069816'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "message": "操作成功",
    "data": {
        "device": {
            "id": 967,
            "memberId": 1,
            "deviceNo": "865214078636124",
            "imei": "865214078636124",
            "mainSimNo": "1064939169796",
            "mainIccid": "898608841925D2210999",
            "vice1SimNo": "1442549810999",
            "vice1Iccid": "8986032142201828602",
            "vice2SimNo": "",
            "vice2Iccid": "",
            "usimIccid": "",
            "usimNo": "",
            "effectiveSim": 2,
            "wisdomNetwork": 0,
            "deviceNetwork": "1,4",
            "customDeviceNetwork": "",
            "rssi": -84,
            "electric": 100,
            "onlineStatus": 1,
            "openAt": null,
            "wifiName": "MIFI-059D",
            "wifiPass": "1234567890",
            "showWifi": 1,
            "connCount": 0,
            "switchWifi": 1,
            "maxConnCount": 10,
            "wifiEncrypt": "WPA2PSK",
            "wifiName5G": "",
            "wifiPass5G": "",
            "showWifi5G": 0,
            "connCount5G": 0,
            "switchWifi5G": 0,
            "maxConnCount5G": 0,
            "wifiEncrypt5G": "",
            "mac": "3C:68:01:97:05:9D",
            "lastTerminalMac": "",
            "webPassword": "admin",
            "position": {
                "cellId": "151007697",
                "cityCode": "441900",
                "lac": "9083",
                "lat": 22.7617255,
                "lng": 114.1027542,
                "mcc": "460",
                "mnc": "0",
                "provinceCode": "440000",
                "regionName": "广东省 东莞市 高园路 靠近石鼓广场",
                "updateAt": null
            },
            "softVersion": "UZ901LD1.0_KSBC_JINANZHENGYI_SL_V2.01.01.02P42U28P1_02-250730",
            "deviceStatus": 3,
            "conned": null,
            "history": null,
            "controlResponse": [
                {
                    "controlAt": "2025-08-01 13:44:57",
                    "eventType": 251,
                    "eventValue1": "1",
                    "eventValue2": ""
                },
                {
                    "controlAt": "2025-08-01 22:45:25",
                    "eventType": 251,
                    "eventValue1": "2",
                    "eventValue2": ""
                },
                {
                    "controlAt": "2025-08-01 22:46:25",
                    "eventType": 251,
                    "eventValue1": "2",
                    "eventValue2": ""
                }
            ],
            "lastDeviceStatusAt": "2025-09-18 18:24:10",
            "lastDeviceFlowAt": "2025-08-20 18:25:19",
            "warrantyExpire": "2000-01-01 00:00:00",
            "status": 1,
            "remark": "",
            "createdAt": "2025-07-30 21:58:48",
            "updatedAt": "2025-09-18 18:24:10"
        },
        "sims": [
            {
                "id": 182717,
                "memberId": 1,
                "gatewayId": 270,
                "gatewaySchemeId": 269,
                "poolId": 0,
                "packageGroupId": 63,
                "rechargeGroupId": 0,
                "limitRuleId": 0,
                "virtualRuleId": 0,
                "breakRuleId": 0,
                "breakAt": "2025-08-20 18:25:19",
                "breakRemoveAt": "2025-08-21 09:59:59",
                "limitFinallyActivateAt": null,
                "couponGroupId": 0,
                "simLayoutId": 0,
                "oneCodeId": 0,
                "volumePackageId": 0,
                "simNo": "1064939169796",
                "dockNo": "1064939169796",
                "iccid": "898608841925D2210999",
                "imsi": "",
                "imei": "865214078636124",
                "deviceNo": "865214078636124",
                "sourceType": 2,
                "vice": 1,
                "mobile": "",
                "balance": 0,
                "arrearsBalance": 0,
                "integral": 0,
                "couponCoin": 0,
                "payPassword": "",
                "simStatus": 4,
                "activateStatus": 2,
                "authStatus": 2,
                "authPlatformStatus": 1,
                "internetStatus": 2,
                "onlineStatus": 2,
                "cancelStatus": 1,
                "replaceStatus": 1,
                "robinStatus": 1,
                "activateAt": "2025-08-12 15:18:42",
                "authAt": null,
                "authPlatformAt": null,
                "rechargeTimes": 1,
                "speedCode": "",
                "releaseSpeedAt": null,
                "speedAt": null,
                "totalFlow": 104857600,
                "useFlow": 20971520,
                "realUseFlow": 20971520,
                "dockUserFlow": 4374736,
                "dockResetDate": "2025-08-01 00:00:00",
                "endAt": "2025-10-18 00:00:00",
                "roundRobinLevel": 2,
                "robinUp": 0,
                "robinDown": 0,
                "lastRobinAt": "2025-08-20 18:25:19",
                "lastSimStatusAt": "2025-09-18 18:24:09",
                "lastActiveAt": "2025-09-09 23:24:53",
                "lastLoginIp": "",
                "lastLoginCity": "",
                "subscribeUrl": "",
                "cleanAuthAt": null,
                "swipeAt": "2025-07-30 21:58:48",
                "swipeRemark": "",
                "remark": "",
                "status": 1,
                "updatedAt": "2025-09-18 18:24:10",
                "createdAt": "2025-07-30 21:58:48"
            },
            {
                "id": 182718,
                "memberId": 1,
                "gatewayId": 270,
                "gatewaySchemeId": 269,
                "poolId": 0,
                "packageGroupId": 63,
                "rechargeGroupId": 0,
                "limitRuleId": 0,
                "virtualRuleId": 0,
                "breakRuleId": 0,
                "breakAt": null,
                "breakRemoveAt": null,
                "limitFinallyActivateAt": null,
                "couponGroupId": 0,
                "simLayoutId": 0,
                "oneCodeId": 0,
                "volumePackageId": 0,
                "simNo": "1442549810999",
                "dockNo": "1442549810999",
                "iccid": "8986032142201828602",
                "imsi": "",
                "imei": "865214078636124",
                "deviceNo": "865214078636124",
                "sourceType": 2,
                "vice": 2,
                "mobile": "",
                "balance": 0,
                "arrearsBalance": 0,
                "integral": 0,
                "couponCoin": 0,
                "payPassword": "",
                "simStatus": 4,
                "activateStatus": 2,
                "authStatus": 1,
                "authPlatformStatus": 1,
                "internetStatus": 1,
                "onlineStatus": 3,
                "cancelStatus": 1,
                "replaceStatus": 1,
                "robinStatus": 1,
                "activateAt": "2023-12-25 21:13:09",
                "authAt": "2025-08-20 18:25:20",
                "authPlatformAt": null,
                "rechargeTimes": 0,
                "speedCode": "",
                "releaseSpeedAt": null,
                "speedAt": null,
                "totalFlow": 104857600,
                "useFlow": 24117248,
                "realUseFlow": 24117248,
                "dockUserFlow": 2789242,
                "dockResetDate": "2025-08-01 00:00:00",
                "endAt": "2025-10-18 00:00:00",
                "roundRobinLevel": 8,
                "robinUp": 0,
                "robinDown": 0,
                "lastRobinAt": "2025-08-20 18:25:19",
                "lastSimStatusAt": "2025-09-18 18:24:10",
                "lastActiveAt": "2025-08-20 18:23:06",
                "lastLoginIp": "",
                "lastLoginCity": "",
                "subscribeUrl": "",
                "cleanAuthAt": null,
                "swipeAt": "2025-07-30 21:58:48",
                "swipeRemark": "",
                "remark": "",
                "status": 1,
                "updatedAt": "2025-09-18 18:24:10",
                "createdAt": "2025-07-30 21:58:48"
            }
        ]
    },
    "timestamp": 1758192050,
    "traceID": "5831f960804c9217ec01e425b8cc76f5"
}
上一页
获取移动流量池Token
下一页
查询设备信息
Built with