Skip to content

Auto-Renewal Task Page ​

Query auto-renewal task execution records with pagination, ordered by task ID descending. Only the current standalone site, the caller and the time range are used for filtering.

Interface Address:

text
/papi/wallet/auto-renew/task/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 and digits

Body Parameters:

ParameterTypeRequiredDescription
pageNointegerNoPage number, starting from 1. Defaults to 1
pageSizeintegerNoPage size. Defaults to 10, max 1000
beginTimelongNoQuery start time, Unix timestamp in milliseconds. Defaults to 30 days before endTime
endTimelongNoQuery end time, Unix timestamp in milliseconds. Defaults to current time

Request Example:

json
{
  "pageNo": 1,
  "pageSize": 10,
  "beginTime": 1793491200000,
  "endTime": 1793577600000
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectReturn data
├─ listarray[object]Data list
├─├─ taskNostringAuto-renewal task number
├─├─ policyIdstringAssociated policy ID
├─├─ resourceTypeintegerResource type: 1 cloud phone, 4 proxy IP, 6 cloud disk
├─├─ resourceUidstringResource identifier
├─├─ cycleExpireTimestringResource expiry time of the renewed cycle
├─├─ currencystringCurrency code
├─├─ currencySymbolstringCurrency symbol, e.g. $ for USD
├─├─ amountstringRenewal amount, in cents
├─├─ orderNostringAssociated order number
├─├─ statusstringTask status: PAID paid but fulfillment pending, SUCCESS completed; other statuses include CREATED, RETRY, CANCELLED, FAILED, MANUAL_REVIEW, PARTIAL_REFUNDED, FULL_REFUNDED
├─├─ retryCountintegerTask retry count
├─├─ errorCodestringError code on failure
├─├─ errorMessagestringError message on failure
├─├─ completedTimestringTask completion time
├─ totalintegerTotal count
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "list": [
      {
        "taskNo": "",
        "policyId": "",
        "resourceType": 1,
        "resourceUid": "",
        "cycleExpireTime": "",
        "currency": "USD",
        "currencySymbol": "$",
        "amount": "1000",
        "orderNo": "",
        "status": "SUCCESS",
        "retryCount": 0,
        "errorCode": null,
        "errorMessage": null,
        "completedTime": ""
      }
    ],
    "total": 0
  },
  "msg": ""
}

Notes:

  • This API only uses pageNo, pageSize, beginTime and endTime; do not rely on type, bizType, currency and similar fields for filtering.
  • The time range must not be reversed or exceed 90 days.

OpenAPI Docs