API 接入指南
API 接入指南

静态代理购买流程

一个静态代理购买订单可以包含多个地区。订单支付成功后异步履约,各地区可能分别成功或失败。

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

    C->>A: 查询静态代理地区
    A-->>C: 返回类型和地区编码
    C->>A: 批量查询所选地区库存
    A-->>C: 按请求顺序返回库存
    C->>A: 使用 regions 创建购买订单
    A-->>C: 返回订单号、主单状态和地区摘要
    loop 主单尚未结束
        C->>A: 按 order_no 查询购买订单列表
        A-->>C: 返回主单和地区状态
    end
    opt 提供了 callback_url
        A->>W: 通知 SUCCESS、PARTIAL_SUCCESS 或 FAILED
        W-->>A: 返回任意 2xx
    end
    C->>A: 查询静态代理资源
    A-->>C: 返回已经成功交付的连接信息

接入步骤

  1. 调用查询静态代理地区,选择一个静态类型及一个或多个地区编码。
  2. 选择统一购买时长:ISP 支持 7、30 天,ISP_NATIVE 支持 7、30、90 天。
  3. 调用查询静态代理库存,在一个 POST 请求中传入所选地区编码。库存不会被预留。
  4. 调用创建静态代理购买订单,将每个地区及数量放入 regions,保存返回的 order_no。
  5. 每 10~30 秒调用查询静态代理购买订单,用 order_no 精确筛选,直到主单为 SUCCESS、PARTIAL_SUCCESS 或 FAILED。
  6. 主单为 SUCCESS 或 PARTIAL_SUCCESS 时,调用查询静态代理资源获取已成功地区的连接信息。

如果提供了 callback_url,仍应保留轮询和补查能力。回调只用于提醒,不能替代订单查询。

FAILED 或 PARTIAL_SUCCESS 不会自动退款,请联系客户支持处理。创建请求返回 300320 时,表示当前类型、地区或周期没有可用价格。

On this page

静态代理购买流程