Skip to content

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/page

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID. See API Rules for authentication
X-SignaturestringYesSignature value, Base64-encoded HMAC-SHA256 result
X-TimestampstringYesMillisecond-level Unix timestamp (13 digits)
X-NoncestringYesRandom string, 10~32 lowercase letters + digits

Body Parameters:

ParameterTypeRequiredDescription
pageNointegerNoPage number, starting from 1, default 1
pageSizeintegerNoPage size, max 1000, default 10
resourceTypeintegerYesResource type (1-cloud phone, 4-proxy IP, 6-cloud disk)

Request Example:

json
{
  "pageNo": 1,
  "pageSize": 10,
  "resourceType": 1
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ listarray[object]Data list
├─├─ resourceUidstringResource 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
├─├─ resourceTypeintegerResource type (1-cloud phone, 4-proxy IP, 6-cloud disk)
├─├─ resourceExpireTimestringResource expiration time (Unix millisecond timestamp)
├─├─ enabledintegerAuto-renewal switch (0-off, 1-on)
├─├─ skuNamestringSKU name
├─├─ packageNamestringPackage name
├─├─ currencystringCurrency code
├─├─ currencySymbolstringCurrency symbol, e.g. $ for USD
├─├─ namestringCloud phone remark (ctrRemark) or proxy name, depending on resource type
├─├─ ctrAliasstringCloud phone alias
├─├─ regionstringProxy IP region
├─├─ regionCnstringProxy IP region (Chinese)
├─├─ egressIpstringProxy egress IP
├─ totalintegerTotal count
msgstringError 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": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center