Linksfield Developer
OverviewCube APIs旧版本API
OverviewCube APIs旧版本API
  1. Usage
  • CSSS APIs
    • 全局说明/Overview
    • 国际化/ Internationalization
    • 状态码/Status code
    • 签名代码示例 / Sign code Example
    • SIM
      • 批量获取拥有的设备信息/Get all SIM cards info
      • 查询单一设备实时信息/Get real-time info about one SIM card
      • 同步使用中SIM卡信息/Get the SIM Cards in use
    • Usage
      • 查询单张SIM卡流量使用情况/ Example Query the traffic usage of a single SIM card
        POST
      • 批量查询SIM卡流量接口 /Batch querying SIM card usage
        POST
      • 查询单日流量使用情况 / Example Query the daily usage
        POST
      • 批量查询指定月份的流量使用情况/ Batch querying the usage in a specified month
        POST
    • 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
      • OTA日套餐下单/Order OTA Plan
      • 运营商侧剩余流量查询/Query the remaing data by MNO side
  • Notification
    • Notification全局说明
    • Notification状态码
    • 流量使用量API预警
      POST
    • 短信下行回调
      POST
    • 短信上行回调
      POST
    • 短信上行回调(区分文本二进制)
      POST
    • 订单状态变更回调(IMSI)
      POST
  • Mall APIs
    • Mall全局说明
    • Mall业务流程
    • Mall签名代码示例
    • APP调用Stripe的SDK示例说明
    • Vshop
      • 卡片登录验证
      • 获取可购套餐商品列表
      • 创建用户订单
      • 查询正在使用、未启用订单
      • 获取生效中的自动续费
      • 关闭自动续费
      • 用户下单(第三方支付)
    • Payment
      • 获取stripe单次支付权限
      • 获取Stripe订阅支付权限
      • 创建Stripe订阅/自动续费
      • 支付结果查询
    • Notification
      • 消息推送
  • eSIM QR Mall APIs
    • Introduction
    • Pre - order
    • webhook
    • 用户登录
    • My eSIM Detail
  1. Usage

查询单张SIM卡流量使用情况/ Example Query the traffic usage of a single SIM card

Cube UAT
https://api-uat.io.linksfield.net/cube/v4
Cube UAT
https://api-uat.io.linksfield.net/cube/v4
POST
/flow/queryDeviceFlowUsage
查询某个设备信息,包括设备当前订单周期流量使用情况。
// Example Query information about a device, including the current order cycle traffic usage.

请求参数

Header 参数
Accept-Language
string 
可选
默认,当header中无语言要求时,默认返回简体中文。当前支持zh-CN(简体中文)、en-US(英文)。/ Support : zh-CN 、 en-US
默认值:
zh-CN
Content-Type
string 
可选
默认值:
application/json
Body 参数application/json
access_code
string 
必需
device_id
string 
必需
设备标识,通常为SIM卡ICCID
// SIM card ICCID.
timestamp
string 
必需
version
string 
必需
sign
string 
必需
示例
{
    "access_code": "P000270",
    "device_id": "89852022018041800192",
    "timestamp": "1643251754",
    "version": "2.0",
    "sign":"wVnILqg0AMS0syL/MOA5LqRpa9I="
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-uat.io.linksfield.net/cube/v4/flow/queryDeviceFlowUsage' \
--header 'Accept-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_code": "P000270",
    "device_id": "89852022018041800192",
    "timestamp": "1643251754",
    "version": "2.0",
    "sign":"wVnILqg0AMS0syL/MOA5LqRpa9I="
}'

返回响应

🟢200Success
application/json
Body
code
string 
必需
data
object 
必需
sign
string 
必需
device_id
string 
必需
设备的标识.
// SIM card ICCID.
order_code
string 
必需
套餐订单编码。
// Data plan ID.
order_used_flow
string 
必需
订单当前周期使用流量;单位为Byte;
// Order current cycle usage ; Byte .
high_flow_balance
string 
必需
订单当前周期剩余流量.
// Order current cycle remaining data.
message
string 
必需
success
boolean 
必需
示例
{
    "code": "0000",
    "data": {
        "sign": "nTrEry3jUd52m4PQ8lmBvsfGsAE=",
        "device_id": "89852022018041800192",
        "order_code": "202107061625560742397",
        "order_used_flow": "0",
        "high_flow_balance": "0"
    },
    "message": "成功",
    "success": true
}
修改于 2022-12-12 03:21:14
上一页
同步使用中SIM卡信息/Get the SIM Cards in use
下一页
批量查询SIM卡流量接口 /Batch querying SIM card usage
Built with