查询特定运营商SIM卡流量用量(A1)
POST
/usage/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")));
请求参数
Body 参数application/json
sim_ids
array[string]
必需
示例
{
"sim_ids": [
"string"
]
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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/"
}
}
最后修改时间: 6 个月前