查询SIM卡当前使用订单累计流量

简要描述

版本：

4.0.0

适用场景：

获取SIM卡当前使用的Bundle/套餐自通信套餐订单启用以来至最后统计时间，其通信套餐订单全部周期的流量累计使用量。

业务说明：

仅统计SIM卡当前生效的一个通信套餐订单数据。

生效指订单状态为使用中或暂停的订单。选取优先级使用中高于暂停。若同一状态订单有多个，则返回启用时间距离当前时间最近的订单数据。

加油包、测试流量不在统计范围内。

通信套餐订单：指领科对SIM进行套餐服务控制、流量统计的基本单元。通常SIM卡绑定一个套餐/Bundle后会在系统产生一个通信套餐订单，在Cube 4.0系统中不直接展示。
加油包：指对特定资源、部分业务推出的套餐周期内流量叠加服务。
测试流量：指SIM卡出厂时选配的超小测试流量。
了解更多请咨询领科支持人员。

必要条件：

SIM卡不支持OTA功能

SIM卡只有一个有效的通信套餐订单

SIM卡生命周期处于使用期/Active-live或暂停期/Paused

通过设备IMEI或SN查询绑定的SIM卡ICCID请使用API Get SIM ID/ICCID

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v1().usage().getSimUsageUwp(new GetSimUsageUwp(1, "89314404000894487785"));
client.v2().usage().getSimUsageUwp(new GetSimUsageUwp(1, "89314404000894487785"));

请求参数

Path 参数

sim_id

string

SIM卡ICCID

必需

Query 参数

timestamp

string

必需

epoc time UTC0

默认值:

1640917845984

Header 参数

Accept-Language

string

可选

默认，当header中无语言要求时，默认返回简体中文。当前支持zh-CN（简体中文）、en-US（英文）。/ Support : zh-CN 、 en-US

默认值:

zh-CN

Content-Type

string

可选

默认值:

application/json

Authorization

string

必需

LF {lfAccessKeyId}/{sign} 必填项

默认值:

X-LF-Api-Version

string

可选

默认值: 此最新版本。如最新版本为2.0，则默认1.0

X-LF-Signature-Type

string

1.0、2.0

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

array [object {3}]

必需

type

string

必需

类型：data（数据）

accu_usage

string

必需

累计用量，单位：Byte（数据）

since

string

必需

统计开始时间，格式：yyyy-mm-dd hh:mm:ss。UTC 0

status

object (status)

必需

code

string

必需

message

string | null

必需

detail

必需

示例

{
    "data": [
        {
            "type": "data",
            "accu_usage": "23153434",
            "since": "2022-08-20 00:00:00"
        }
    ],
    "status": {
        "code": "CB-00-0000",
        "message": "success",
        "detail": null
    }
}

查询SIM卡当前使用订单累计流量

简要描述#

版本：#

适用场景：#

业务说明：#

必要条件：#

SDK API 调用方式#

请求参数

示例代码

返回响应

简要描述

版本：

适用场景：

业务说明：

必要条件：

SDK API 调用方式