查询特定运营商SIM卡流量用量（A1）

适用场景

查询批量SIM卡当月流量使用量。（特定运营商SIM卡）

必要条件

仅支持对所用API key归属企业下的卡片进行操作。

仅对部分SIM卡生效（特定运营商），详询领科支撑人员。

注意事项

接口为同步返回结果，查询数据量大时将存在一定响应时间。

接口返回依赖运营商的系统响应，存在响应超时的风险，若发生超时请尝试再次请求或减少查询SIM卡数量。

接口本月统计的时区为：CET时间
每年3月最后一个周日1:00开始，到10月的最后一个周日1:00结束，期间为UTC+2（即夏令时与北京时间相差6小时），此时间外为UTC+1（即冬令时与北京时间相差7小时）

业务规则

支持批量SIM卡的数据查询，一次最大支持1000张（待定）。

查询时，若SIM卡中包含其他非特定运营商的SIM卡，则查询程序终止并返回对应错误码。

SDK API 调用方式

PartnerClient client = new PartnerClient(accessKey,privateKey)
client.v2().usage().getSimUsageA1(new GetSimUsageA1(3, Lists.newArrayList("89852202309200000007")));

请求参数

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

可选

timestamp

string

必需

毫秒时间戳；只接受10分钟之内请求

nonce

integer

必需

随机正整数，取值范围：0-2147483647

Body 参数application/json

sim_ids

array[string]

必需

示例

{
  "sim_ids": [
    "string"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

array [object {2}]

必需

sim_id

string

SIM卡ICCID

必需

data_usage

integer

必需

本月（CET时区）已用流量，单位byte

status

object

必需

code

string

必需

message

string

必需

detail

string

必需

示例

{
  "data": [
    {
      "sim_id": "89430101521032290021",
      "data_usage": 0
    },
    {
      "sim_id": "89430101521032302347",
      "data_usage": 0
    }
  ],
  "status": {
    "code": "CB-00-0000",
    "message": "成功",
    "detail": "https://apidoc-cn.iotcube.link/"
  }
}

🟢200success

查询特定运营商SIM卡流量用量（A1）

适用场景#

必要条件#

注意事项#

业务规则#

SDK API 调用方式#

请求参数

示例代码

返回响应

适用场景

必要条件

注意事项

业务规则

SDK API 调用方式