自动续费策略分页
按资源类型分页查询自动续费策略。云机与代理 IP 查询本人策略,云盘按当前团队查询;已过期资源不返回。
接口地址:
text
/papi/wallet/auto-renew/page请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageNo | integer | 否 | 页码,从 1 开始,默认 1 |
| pageSize | integer | 否 | 每页数量,默认 10,最大 1000 |
| resourceType | integer | 是 | 资源类型:1 云机、4 代理 IP、6 云盘 |
请求示例:
json
{
"pageNo": 1,
"pageSize": 10,
"resourceType": 1
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ list | array[object] | 数据列表 |
| ├─├─ resourceUid | string | 资源标识,用于更新接口;云机为 ctrId,IP 为代理 IP 的 uid,云盘为该笔购买记录的 ID 字符串 |
| ├─├─ resourceType | integer | 资源类型:1 云机、4 代理 IP、6 云盘 |
| ├─├─ resourceExpireTime | string | 资源到期时间,Unix 毫秒时间戳 |
| ├─├─ enabled | integer | 自动续费开关:0 关闭、1 开启 |
| ├─├─ skuName | string | 商品规格名称,按 Accept-Language 返回翻译 |
| ├─├─ packageName | string | 套餐名称,按 Accept-Language 返回翻译 |
| ├─├─ currency | string | 币种代码 |
| ├─├─ currencySymbol | string | 货币符号,如 USD 的 $ |
| ├─├─ name | string | 云机备注(ctrRemark)或代理名称,随资源类型变化 |
| ├─├─ ctrAlias | string | 云机别名(仅云机类型返回) |
| ├─├─ region | string | 代理 IP 归属地区(仅 IP 类型返回) |
| ├─├─ regionCn | string | 代理 IP 归属地区中文名(仅 IP 类型返回) |
| ├─├─ egressIp | string | 代理出口 IP(仅 IP 类型返回) |
| ├─ total | integer | 总量 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": {
"list": [
{
"resourceUid": "",
"resourceType": 1,
"resourceExpireTime": "",
"enabled": 1,
"skuName": "",
"packageName": "",
"currency": "USD",
"currencySymbol": "$",
"name": "",
"ctrAlias": "",
"region": null,
"regionCn": null,
"egressIp": null
}
],
"total": 0
},
"msg": ""
}说明:
- 只有静态住宅 IP 和静态数据中心 IP 支持自动续费,动态 IP 不支持。
- 不要把云机展示用的
ctrAlias代替resourceUid;云盘每笔购买记录独立设置策略。 - 部分字段可能因资源信息缺失而为 null。
