查询自动续费任务
分页查询自动续费任务的执行记录,按任务 ID 倒序,仅按当前独立站、本人及时间范围查询。
接口地址:
text
/papi/wallet/auto-renew/task/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 |
| beginTime | long | 否 | 查询起始时间,Unix 毫秒时间戳,默认结束时间前 30 天 |
| endTime | long | 否 | 查询结束时间,Unix 毫秒时间戳,默认当前时间 |
请求示例:
json
{
"pageNo": 1,
"pageSize": 10,
"beginTime": 1793491200000,
"endTime": 1793577600000
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ list | array[object] | 数据列表 |
| ├─├─ taskNo | string | 自动续费任务编号 |
| ├─├─ policyId | string | 关联策略 ID |
| ├─├─ resourceType | integer | 资源类型:1 云机、4 代理 IP、6 云盘 |
| ├─├─ resourceUid | string | 资源标识 |
| ├─├─ cycleExpireTime | string | 本续费周期的资源到期时间 |
| ├─├─ currency | string | 币种代码 |
| ├─├─ currencySymbol | string | 货币符号,如 USD 的 $ |
| ├─├─ amount | string | 续费金额,单位为美分 |
| ├─├─ orderNo | string | 关联订单号 |
| ├─├─ status | string | 任务状态:PAID 已支付但履约待核对,SUCCESS 已完成;其他状态包括 CREATED、RETRY、CANCELLED、FAILED、MANUAL_REVIEW、PARTIAL_REFUNDED、FULL_REFUNDED |
| ├─├─ retryCount | integer | 任务重试次数 |
| ├─├─ errorCode | string | 失败错误码 |
| ├─├─ errorMessage | string | 失败错误信息 |
| ├─├─ completedTime | string | 任务完成时间 |
| ├─ total | integer | 总量 |
| msg | string | 错误提示 |
响应示例:
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": ""
}说明:
- 本接口实际只使用
pageNo、pageSize、beginTime、endTime,不要依赖type、bizType、currency等字段筛选。 - 时间范围不得倒置或超过 90 天。
