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: 返回已经成功交付的连接信息
接入步骤
- 调用查询静态代理地区,选择一个静态类型及一个或多个地区编码。
- 选择统一购买时长:
ISP支持7、30天,ISP_NATIVE支持7、30、90天。 - 调用查询静态代理库存,在一个 POST 请求中传入所选地区编码。库存不会被预留。
- 调用创建静态代理购买订单,将每个地区及数量放入
regions,保存返回的order_no。 - 每 10~30 秒调用查询静态代理购买订单,用
order_no精确筛选,直到主单为SUCCESS、PARTIAL_SUCCESS或FAILED。 - 主单为
SUCCESS或PARTIAL_SUCCESS时,调用查询静态代理资源获取已成功地区的连接信息。
如果提供了 callback_url,仍应保留轮询和补查能力。回调只用于提醒,不能替代订单查询。
FAILED 或 PARTIAL_SUCCESS 不会自动退款,请联系客户支持处理。创建请求返回 300320 时,表示当前类型、地区或周期没有可用价格。