OpenAPI 接口文档
OpenAPI 接口文档

静态代理续费流程

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

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

    C->>A: 查询静态代理资源
    A-->>C: 返回资源编号和到期时间
    C->>A: 获取续费报价(资源、统一时长)
    A-->>C: 返回当前总金额,不锁价
    C->>A: 创建续费订单(资源、统一时长、request_no,可选 callback_url)
    A-->>C: 支付成功,返回 PROCESSING 和订单号
    par 自动轮询
        loop 订单为 PROCESSING,或 FAILED 且仍有资源为 PROCESSING
            C->>A: 查询续费订单详情
            A-->>C: 返回订单和资源级状态
        end
    and 提供了 callback_url
        A->>W: 第一次进入 COMPLETED 或 FAILED 时通知一次
        W-->>A: 返回任意 2xx
    end
    C->>A: 查询续费订单详情
    A-->>C: 返回最新订单和资源结果

接入步骤

  1. 调用查询静态代理资源,选择当前为 ACTIVE 且尚未过期的 id
  2. 为整单选择统一时长:全部为 ISP 时可选 730 天;全部为 ISP_NATIVE 时可选 73090 天;混合两种类型时可选 730 天。
  3. 调用获取静态代理续费报价取得当前总金额。报价不创建订单、不扣款,也不锁定价格。
  4. 调用创建静态代理续费订单,保存返回的 order_no。创建时会重新检查资源状态并重新计价,实际金额可能与报价不同。
  5. 每 10~30 秒调用查询静态代理续费订单详情:订单为 COMPLETED 时可以停止;订单为 FAILED 时,继续查询,直到 resources 中所有 status 都不再是 PROCESSING,再停止自动轮询并联系客户支持。
  6. 读取 resources 中每个资源的状态和最新到期时间。

订单为 COMPLETED 时,订单级 finish_time 表示全部资源完成的时间。订单为 FAILED 时,订单级 finish_time 表示首次出现失败结果的时间,不表示全部资源均已处理结束。已经续费成功的资源保留新的到期时间。

回调只会在订单第一次进入 COMPLETEDFAILED 时发送一次,失败不重试,也不会在剩余资源处理结束后再次发送。FAILED 不会自动退款;联系客户支持人工处理后,应重新查询订单详情获取最新结果。

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

On this page