API 接入指南
API 接入指南

静态代理续费流程

静态代理续费在订单受理并支付成功后进入异步处理。一次请求可以续费 1~500 个去重后的资源,全部资源使用相同的续费时长;多个资源的结果可能不同。

sequenceDiagram
    participant C as 调用方
    participant A as Open API
    participant W as 回调接收地址

    C->>A: 查询静态代理资源
    A-->>C: 返回资源编号和到期时间
    C->>A: 创建续费订单(资源、统一时长、request_no,可选 callback_url)
    A-->>C: 支付成功,返回 PROCESSING 和订单号
    par 自动轮询
        loop 订单为 PROCESSING
            C->>A: 按订单号查询续费订单列表
            A-->>C: 返回订单状态
        end
    and 提供了 callback_url
        A->>W: 第一次进入 COMPLETED 或 FAILED 时通知一次
        W-->>A: 返回任意 2xx
    end
    C->>A: 按订单号查询续费订单列表
    A-->>C: 返回最新订单状态
    C->>A: 查询静态代理资源
    A-->>C: 返回最新到期时间

接入步骤

  1. 调用查询静态代理资源,选择当前为 ACTIVE 且尚未过期的 id。
  2. 为整单选择统一时长:全部为 ISP 时可选 7、30 天;全部为 ISP_NATIVE 时可选 7、30、90 天;混合两种类型时可选 7、30 天。
  3. 直接调用创建静态代理续费订单,保存返回的 order_no。创建时会检查资源状态并按下单时的价格计算订单金额。
  4. 每 10~30 秒调用查询静态代理续费订单,使用 order_no 精确筛选;订单为 COMPLETED 时停止轮询,订单为 FAILED 时停止自动轮询并联系客户支持。
  5. 再次调用查询静态代理资源,在分页结果中匹配本次提交的资源 ID,获取最新到期时间。

订单为 COMPLETED 时,订单级 finish_time 表示全部资源完成的时间。订单为 FAILED 时,已经续费成功的资源仍保留新的到期时间。

回调只会在订单第一次进入 COMPLETED 或 FAILED 时发送一次,失败不重试。FAILED 不会自动退款;联系客户支持人工处理后,应重新查询续费订单列表和静态代理资源获取最新结果。

创建请求返回 300320 表示资源价格不存在或与请求规格不匹配;实际 msg 按 X-LANG 返回,省略或不支持时使用 en_US。

On this page