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: 返回最终状态和资源
接入步骤
- 调用查询静态代理地区,选择静态类型和地区编码。
- 选择购买时长:
ISP仅支持7、30天,ISP_NATIVE支持7、30、90天。 - 调用查询静态代理库存。库存是实时结果,创建订单时仍可能发生变化。
- 调用获取静态代理购买报价取得当前总金额。报价不创建订单、不扣款、不预留库存,也不锁定价格。
- 调用创建静态代理购买订单,保存返回的
order_no。创建时会重新核对库存并重新计价,实际金额可能与报价不同。 - 每 10~30 秒调用查询静态代理购买订单详情,直到状态为
COMPLETED或FAILED。 COMPLETED时从详情的resources获取连接信息。
如果创建订单时提供 callback_url,仍必须保留轮询和补查能力。回调只用于提醒,不能替代订单查询。
如果订单为 FAILED,不会自动退款。请联系客户支持人工处理。
创建请求返回 300320 表示资源价格不存在或与请求规格不匹配;实际 msg 按 X-LANG 返回,省略或不支持时使用 en_US。