查询SIM卡累计流量

Cube Prod

GET

https://api.linksfield.net/cube/v4/sims/{sim_id}/usage

简要描述

版本：

v4

适用场景：

查询SIM卡某时间段内的流量日、或月统计。

业务说明：

category当前支持流量用量查询。

period_type支持按自然日、自然月查询，统计周期默认为UTC 0时区。

可查询当日、当月的统计数据。按日查询支持60天（含）内、按月查询支持6个月（含）内的数据查询。

日统计更新频率为1小时，月统计更新频率为1天。

不同运营商话单延迟时间不等，统计周期内的话单统计可能会发生变化。

当前仅支持2023-01-01以后的数据查询。

请求示例：

示例1：查询22年10月1日流量日统计
/sims/89852123456789012345/usage?category=data&period_type=1&begin_from=2022-10-01&end_by=2022-10-01&timestamp=1640917845984

示例2：查询22年10月-11月流量月统计
/sims/89852123456789012345/usage?category=data&period_type=2&begin_from=2022-10&end_by=2022-11&timestamp=1640917845984

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v1().usage().getSimUsage(new GetSimUsage(1, "89852202106290373769", "data", "1", "2023-02-19", "2023-03-16"));
client.v2().usage().getSimUsage(new GetSimUsage(1, "89852202106290373769", "data", "1", "2023-02-19", "2023-03-16"));

请求参数

Path 参数

sim_id

string

必需

SIM卡片ICCID

Query 参数

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.linksfield.net/cube/v4/sims//usage?category=&period_type=&begin_from=&end_by=' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization;' \
--header 'X-LF-Api-Version;' \
--header 'X-LF-Signature-Type;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'Content-Type: application/json'

返回响应

🟢200成功

application/json

Body

data

object

必需

sim_id

string

SIM卡ICCID

必需

usage

array [object {3}]

必需

status

object (status)

必需

code

string

必需

message

string | null

必需

detail

必需

示例

{
  "data": {
    "sim_id": "89852202306300023442",
    "usage": [
      {
        "period": "2023-07-12",
        "update_at": "2023-07-13T14:05:02",
        "data": {
          "all": 32000
        }
      },
      {
        "period": "2023-07-13",
        "update_at": "2023-07-13T18:05:02",
        "data": {
          "all": 208000
        }
      },
      {
        "period": "2023-07-14",
        "update_at": "2023-07-14T18:05:02",
        "data": {
          "all": 96000
        }
      },
      {
        "period": "2023-07-17",
        "update_at": "2023-07-17T11:05:02",
        "data": {
          "all": 32000
        }
      }
    ]
  },
  "status": {
    "code": "CB-00-0000",
    "message": "成功",
    "detail": "https://developer.linksfield.net/doc-1413557?nav=01GBM770ARR76AXBD5856Z6J6P"
  }
}

🟢200success

修改于 2024-03-11 08:34:24

选择并锁定本地网络

SMS

查询SIM卡累计流量

简要描述#

版本：#

适用场景：#

业务说明：#

请求示例：#

SDK API 调用方式#

请求参数

示例代码

返回响应

简要描述

版本：

适用场景：

业务说明：

请求示例：

SDK API 调用方式