批量查询SIM卡日用量 - ListSimCardFlowPerDay
功能介绍
批量查询SIM卡日用量接口，支持按天或按月查询。该接口可用于获取历史日期日用量，支持的日期查询范围为上月第一天至当前时间的前一天。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v1/sim-cards/batch-daily-flow
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
sim_card_ids | 否 | Array of longs | SIM卡标识列表，最多支持传入100个SIM卡标识；不支持与容器ID列表（iccids）同时传递。 最大长度：100 |
iccids | 否 | Array of strings | 容器ID列表，最多支持传入100个容器ID；不支持与SIM卡标识列表（sim_card_ids）同时传递。 最大长度：100 |
month | 否 | String | 月份，格式YYYYMM；支持传入上月及当月月份，不支持与日期（date）同时传递。 最小长度：6 最大长度：6 |
date | 否 | String | 日期，格式YYYYMMDD；支持传入上月第一天至当前时间前一天范围内的日期，不支持与月份（month）同时传递。 最小长度：8 最大长度：8 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
[数组元素] | Array of SimCardFlowPerDayRsp objects | - |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误描述 |
状态码：500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误描述 |
请求示例
-
POST https://{endpoint}/v1/sim-cards/batch-daily-flow { "month" : "202408", "sim_card_ids" : [ 5702790861709056, 5702790861709057 ] } -
POST https://{endpoint}/v1/sim-cards/batch-daily-flow { "date" : 20240821, "iccids" : [ "898600xxxxxxxxxx", "898601xxxxxxxxxx" ] }
响应示例
状态码：200
OK
[ {
"date" : "20240801",
"sim_flow" : [ {
"flow" : 0.98,
"iccid" : "898600xxxxxxxxxx",
"sim_card_id" : 5702790861709056
}, {
"flow" : 1.0,
"iccid" : "898601xxxxxxxxxx",
"sim_card_id" : 5702790861709057
} ]
}, {
"date" : "20240802",
"sim_flow" : [ {
"flow" : 0.98,
"iccid" : "898600xxxxxxxxxx",
"sim_card_id" : 5702790861709056
}, {
"flow" : 1.0,
"iccid" : "898601xxxxxxxxxx",
"sim_card_id" : 5702790861709057
} ]
} ] 状态码：400
Bad Request
{
"error_code" : "GSL.00010004",
"error_msg" : "参数异常"
} 状态码：500
Internal Server Error
{
"error_code" : "GSL.00010003",
"error_msg" : "系统繁忙，请稍后重试。"
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
500 | Internal Server Error |
错误码
请参见错误码。
