Skip to content

自动续费策略分页 ​

按资源类型分页查询自动续费策略。云机与代理 IP 查询本人策略,云盘按当前团队查询;已过期资源不返回。

接口地址:

text
/papi/wallet/auto-renew/page

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

参数类型必填说明
pageNointeger否页码,从 1 开始,默认 1
pageSizeinteger否每页数量,默认 10,最大 1000
resourceTypeinteger是资源类型:1 云机、4 代理 IP、6 云盘

请求示例:

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

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ listarray[object]数据列表
├─├─ resourceUidstring资源标识,用于更新接口;云机为 ctrId,IP 为代理 IP 的 uid,云盘为该笔购买记录的 ID 字符串
├─├─ resourceTypeinteger资源类型:1 云机、4 代理 IP、6 云盘
├─├─ resourceExpireTimestring资源到期时间,Unix 毫秒时间戳
├─├─ enabledinteger自动续费开关:0 关闭、1 开启
├─├─ skuNamestring商品规格名称,按 Accept-Language 返回翻译
├─├─ packageNamestring套餐名称,按 Accept-Language 返回翻译
├─├─ currencystring币种代码
├─├─ currencySymbolstring货币符号,如 USD 的 $
├─├─ namestring云机备注(ctrRemark)或代理名称,随资源类型变化
├─├─ ctrAliasstring云机别名(仅云机类型返回)
├─├─ regionstring代理 IP 归属地区(仅 IP 类型返回)
├─├─ regionCnstring代理 IP 归属地区中文名(仅 IP 类型返回)
├─├─ egressIpstring代理出口 IP(仅 IP 类型返回)
├─ totalinteger总量
msgstring错误提示

响应示例:

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。

OpenAPI Docs