批量查询SIM卡日用量
功能介绍
批量查询SIM卡日用量接口，支持按天或按月查询。该接口可用于获取历史日期日用量，支持的日期查询范围为上月第一天至当前时间的前一天。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
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 |
OK |
状态码： 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 |
错误码
请参见错误码。
