Auto-Renew Policy Page
Paginated query of auto-renewal policies. Expired resources are not returned; cloud phone and proxy IP policies are queried for the current user, and cloud disk policies are queried for the current team. Only static residential IPs and static datacenter IPs support auto-renewal; dynamic IPs do not.
Interface Address:
text
/papi/wallet/auto-renew/pageRequest Method:
text
POSTContent-Type:
text
application/jsonHeader Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Access-Key | string | Yes | API access key ID. See API Rules for authentication |
| X-Signature | string | Yes | Signature value, Base64-encoded HMAC-SHA256 result |
| X-Timestamp | string | Yes | Millisecond-level Unix timestamp (13 digits) |
| X-Nonce | string | Yes | Random string, 10~32 lowercase letters + digits |
Body Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| pageNo | integer | No | Page number, starting from 1, default 1 |
| pageSize | integer | No | Page size, max 1000, default 10 |
| resourceType | integer | Yes | Resource type (1-cloud phone, 4-proxy IP, 6-cloud disk) |
Request Example:
json
{
"pageNo": 1,
"pageSize": 10,
"resourceType": 1
}Response Parameters:
| Parameter | Type | Description |
|---|---|---|
| code | integer | Error code. See Error Codes |
| data | object | Response data |
| ├─ list | array[object] | Data list |
| ├─├─ resourceUid | string | Resource identifier; for cloud phones it is the cloud phone ID (ctrId), for proxy IPs it is the proxy IP UID, and for cloud disks it is the cloud disk purchase record ID. Do not use the display-only ctrAlias instead |
| ├─├─ resourceType | integer | Resource type (1-cloud phone, 4-proxy IP, 6-cloud disk) |
| ├─├─ resourceExpireTime | string | Resource expiration time (Unix millisecond timestamp) |
| ├─├─ enabled | integer | Auto-renewal switch (0-off, 1-on) |
| ├─├─ skuName | string | SKU name |
| ├─├─ packageName | string | Package name |
| ├─├─ currency | string | Currency code |
| ├─├─ currencySymbol | string | Currency symbol, e.g. $ for USD |
| ├─├─ name | string | Cloud phone remark (ctrRemark) or proxy name, depending on resource type |
| ├─├─ ctrAlias | string | Cloud phone alias |
| ├─├─ region | string | Proxy IP region |
| ├─├─ regionCn | string | Proxy IP region (Chinese) |
| ├─├─ egressIp | string | Proxy egress IP |
| ├─ total | integer | Total count |
| msg | string | Error message |
Response Example:
json
{
"code": 0,
"data": {
"list": [
{
"resourceUid": "10001",
"resourceType": 1,
"resourceExpireTime": "1796265600000",
"enabled": 1,
"skuName": "",
"packageName": "",
"currency": "USD",
"currencySymbol": "$",
"name": "",
"ctrAlias": "",
"region": "",
"regionCn": "",
"egressIp": ""
}
],
"total": 1
},
"msg": ""
}