短信量包查询
更新时间:2025-12-12
描述
获取商户短信量包详情
参数说明
| 参数名称 | 类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
| userId | String | 是 | 商户的用户ID | 083aabc161be293a24c5768ee4864b77 |
| pageNo | String | 否 | 查询页所在位置 默认:1 |
1 |
| pageSize | String | 否 | 查询页量包数量 默认:10 |
10 |
| countryType | String | 否 | 不填默认查询所有类型 签名适用的国家类型 domestic:国内 international:国际/港澳台 global:全球均适用 |
domestic |
| packageStatus | String | 否 | 不填默认查询所有类型 量包可用状态 RUNNING:使用中 EXPIRED:已过期 USED_UP:已用完 DESTROYED:已销毁 |
RUNNING |
量包结果属性
| 参数名称 | 类型 | 描述 | 注意事项 |
|---|---|---|---|
| prepaidPackages | List | PrepaidPackage数组,一个PrepaidPackage对应一个量包 | - |
| totalCount | int | 用户查询到量包总数 | - |
PrepaidPackage定义
| 参数名称 | 类型 | 描述 | 注意事项 |
|---|---|---|---|
| packageId | String | 量包ID | - |
| name | String | 量包名称 | - |
| countryType | String | 量包适用国家类型 DOMESTIC:国内 INTERNATIONAL:国际/港澳台 GLOBAL:全球 |
- |
| capacity | BigDecimal | 量包短信总量条数 | - |
| remainingCapacity | BigDecimal | 量包短信剩余用量条数 | - |
| packageStatus | String | 量包可用状态 RUNNING:使用中 EXPIRED:已过期 USED_UP:已用完 DESTROYED:已销毁 |
- |
| purchaseDate | Date | 量包购买时间 | - |
| expiryDate | Date | 量包过期时间 | - |
代码示例
Java
1 GetPrepaidPackageRequest request = new GetPrepaidPackageRequest();
2 // 设置必要的参数
3 request.setUserId("your_userID");
4 // 设置可选参数
5 request.setPageNo("1");
6 request.setPageSize("5");
7 request.setPackageStatus("EXPIRED");
8 request.setCountryType("domestic");
9 // 获取查询结果
10 try {
11 GetPrepaidPackageResponse response = smsClient.getPrepaidPackages(request);
12 System.out.println(response.toString());
13 } catch (BceServiceException e) {
14 e.printStackTrace();
15 }
