Linksfield Developer
OverviewCube APIs旧版本API
OverviewCube APIs旧版本API
  1. Customized
  • 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
      • 批量查询SIM卡流量接口 /Batch querying SIM card usage
      • 查询单日流量使用情况 / Example Query the daily usage
      • 批量查询指定月份的流量使用情况/ Batch querying the usage in a specified month
    • 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
        POST
      • 运营商侧剩余流量查询/Query the remaing data by MNO side
        POST
  • 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
      POST
    • webhook
      POST
    • 用户登录
      POST
    • My eSIM Detail
      POST
  1. Customized

运营商侧剩余流量查询/Query the remaing data by MNO side

Cube UAT
https://api-uat.io.linksfield.net/cube/v4
Cube UAT
https://api-uat.io.linksfield.net/cube/v4
POST
/flow/getInfoByDeviceId
查询SIM卡正在使用的订单中使用的imsi,在运营商侧该imsi剩余流量。
仅能返回1个imsi的流量数据,若该SIM卡存在多个imsi将存在数据错乱的可能。
该功能仅对特定资源的imsi使用,具体资源支撑情况请咨询领科支持人员。
Query the IMSI used in the order that the SIM card is in use and the remaining data by MNO side.
Remaining data of only one IMSI can be returned. If the SIM card has multiple IMSI, data may be incorrect.
This function applies only to the IMSI of specific resources. For details about resource support, contact the Linksfield support personnel.

请求参数

Header 参数
Accept-Language
string 
可选
默认,当header中无语言要求时,默认返回简体中文。当前支持zh-CN(简体中文)、en-US(英文)。/ Support : zh-CN 、 en-US
默认值:
zh-CN
Content-Type
string 
可选
默认值:
application/json
Body 参数application/json
version
string 
必需
通信协议版本号,当前版本为2.0
// version, 2.0
timestamp
string 
必需
发送请求的UTC时间戳(秒),和互联网时间误差不能超过 5 分钟。
// timestamp, And the Internet time error cannot exceed 5 minutes.
sign
string 
必需
签名信息
// sign
access_code
string 
必需
企业编码
// partner code
device_id
string 
必需
设备标识,通常为SIM卡的ICCID
// SIM card ICCID.
示例
{
    "version":"2.0",
    "timestamp":"",
    "sign":"kePIsPsCCZEYSLE/QNxW/s2RYik=",
    "access_code":"P000001",
    "device_id":"89314404000894480434"
}

示例代码

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/getInfoByDeviceId' \
--header 'Accept-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "version":"2.0",
    "timestamp":"",
    "sign":"kePIsPsCCZEYSLE/QNxW/s2RYik=",
    "access_code":"P000001",
    "device_id":"89314404000894480434"
}'

返回响应

🟢200Success
application/json
Body
code
string 
必需
message
string 
必需
data
array [object {3}] 
必需
type
string 
可选
类型:call-out(语音)、sms-out(短信)、data(流量)
remainingQuantity
string 
可选
余量,单位:秒(语音)、条数(短信)、Byte(流量)
/Remaining data , Unit:Second(Voice)、Time(SMS)、Byte(data)
msg
string 
可选
失败原因
/Cause of failure
示例
{
    "code": "0000",
    "data": [
        {
            "type": "data",
            "remainingQuantity": "1879048192",
            "msg": null
        }
    ],
    "message": "成功",
    "success": true
}
修改于 2022-12-12 03:21:14
上一页
OTA日套餐下单/Order OTA Plan
下一页
Notification全局说明
Built with