查询SIM卡当前使用订单累计流量
将废弃GET
/usage/statistics/{sim_id}/accu_usage简要描述
版本:
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
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
array [object {3}]
必需
type
string
必需
类型:data(数据)
accu_usage
string
必需
累计用量,单位:Byte(数据)
since
string
必需
统计开始时间,格式:yyyy-mm-dd hh:mm:ss。UTC 0
status
#/definitions/41430733必需
示例
{
"data": [
{
"type": "data",
"accu_usage": "23153434",
"since": "2022-08-20 00:00:00"
}
],
"status": {
"code": "CB-00-0000",
"message": "success",
"detail": null
}
}
最后修改时间: 1 年前