OpenAPI 接口文档
OpenAPI 接口文档

静态代理购买流程

静态代理购买在订单受理并支付成功后进入异步处理,成功响应不表示资源已经可用。正常处理时,要么整单全部购买成功,要么整单失败,不会出现部分采购成功。

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

    C->>A: 查询静态代理地区
    A-->>C: 返回类型和地区编码
    C->>A: 查询实时库存
    A-->>C: 返回可用数量
    C->>A: 获取购买报价(类型、地区、时长、数量)
    A-->>C: 返回当前总金额,不锁价
    C->>A: 创建购买订单(类型、地区、时长、request_no,可选 callback_url)
    A-->>C: 支付成功,返回 PURCHASING 和订单号
    loop 订单尚未结束
        C->>A: 查询购买订单详情
        A-->>C: 返回 PURCHASING
    end
    opt 提供了 callback_url
        A->>W: 通知 COMPLETED 或 FAILED
        W-->>A: 返回任意 2xx
    end
    C->>A: 查询购买订单详情
    A-->>C: 返回最终状态和资源

接入步骤

  1. 调用查询静态代理地区,选择静态类型和地区编码。
  2. 选择购买时长:ISP 仅支持 730 天,ISP_NATIVE 支持 73090 天。
  3. 调用查询静态代理库存。库存是实时结果,创建订单时仍可能发生变化。
  4. 调用获取静态代理购买报价取得当前总金额。报价不创建订单、不扣款、不预留库存,也不锁定价格。
  5. 调用创建静态代理购买订单,保存返回的 order_no。创建时会重新核对库存并重新计价,实际金额可能与报价不同。
  6. 每 10~30 秒调用查询静态代理购买订单详情,直到状态为 COMPLETEDFAILED
  7. COMPLETED 时从详情的 resources 获取连接信息。

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

如果订单为 FAILED,不会自动退款。请联系客户支持人工处理。

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

On this page