查询SIM卡累计流量
GET
/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×tamp=1640917845984示例2:查询22年10月-11月流量月统计
/sims/89852123456789012345/usage?category=data&period_type=2&begin_from=2022-10&end_by=2022-11×tamp=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"));
请求参数
SIM卡片ICCID
查询种类,当前支持:data-流量,未来支持:voice-语音,sms-短信,all-全部
统计周期类型:1-自然日,2-自然月,UTC 0
查询开始日期。当period_type=1时,输入格式示例为2022-10-01,支持当日,距离当日不超过30天。当period_type=2时,输入格式示例为2022-10,支持当月,距离当月不超过6个月。
查询结束日期,不能早于开始时间。当period_type=1时,输入格式示例为2022-10-01,支持当日。当period_type=2时,输入格式示例为2022-10,支持当月。
示例代码
返回响应
{
"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"
}
}