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: 返回最新订单和资源结果
接入步骤
- 调用查询静态代理资源,选择当前为
ACTIVE且尚未过期的id。 - 为整单选择统一时长:全部为
ISP时可选7、30天;全部为ISP_NATIVE时可选7、30、90天;混合两种类型时可选7、30天。 - 调用获取静态代理续费报价取得当前总金额。报价不创建订单、不扣款,也不锁定价格。
- 调用创建静态代理续费订单,保存返回的
order_no。创建时会重新检查资源状态并重新计价,实际金额可能与报价不同。 - 每 10~30 秒调用查询静态代理续费订单详情:订单为
COMPLETED时可以停止;订单为FAILED时,继续查询,直到resources中所有status都不再是PROCESSING,再停止自动轮询并联系客户支持。 - 读取
resources中每个资源的状态和最新到期时间。
订单为 COMPLETED 时,订单级 finish_time 表示全部资源完成的时间。订单为 FAILED 时,订单级 finish_time 表示首次出现失败结果的时间,不表示全部资源均已处理结束。已经续费成功的资源保留新的到期时间。
回调只会在订单第一次进入 COMPLETED 或 FAILED 时发送一次,失败不重试,也不会在剩余资源处理结束后再次发送。FAILED 不会自动退款;联系客户支持人工处理后,应重新查询订单详情获取最新结果。
创建请求返回 300320 表示资源价格不存在或与请求规格不匹配;实际 msg 按 X-LANG 返回,省略或不支持时使用 en_US。