API 接入指南
API 接入指南
静态代理续费流程
静态代理续费在订单受理并支付成功后进入异步处理。一次请求可以续费 1~500 个去重后的资源,全部资源使用相同的续费时长;多个资源的结果可能不同。
sequenceDiagram
participant C as 调用方
participant A as Open API
participant W as 回调接收地址
C->>A: 查询静态代理资源
A-->>C: 返回资源编号和到期时间
C->>A: 创建续费订单(资源、统一时长、request_no,可选 callback_url)
A-->>C: 支付成功,返回 PROCESSING 和订单号
par 自动轮询
loop 订单为 PROCESSING
C->>A: 按订单号查询续费订单列表
A-->>C: 返回订单状态
end
and 提供了 callback_url
A->>W: 第一次进入 COMPLETED 或 FAILED 时通知一次
W-->>A: 返回任意 2xx
end
C->>A: 按订单号查询续费订单列表
A-->>C: 返回最新订单状态
C->>A: 查询静态代理资源
A-->>C: 返回最新到期时间
接入步骤
- 调用查询静态代理资源,选择当前为
ACTIVE且尚未过期的id。 - 为整单选择统一时长:全部为
ISP时可选7、30天;全部为ISP_NATIVE时可选7、30、90天;混合两种类型时可选7、30天。 - 直接调用创建静态代理续费订单,保存返回的
order_no。创建时会检查资源状态并按下单时的价格计算订单金额。 - 每 10~30 秒调用查询静态代理续费订单,使用
order_no精确筛选;订单为COMPLETED时停止轮询,订单为FAILED时停止自动轮询并联系客户支持。 - 再次调用查询静态代理资源,在分页结果中匹配本次提交的资源 ID,获取最新到期时间。
订单为 COMPLETED 时,订单级 finish_time 表示全部资源完成的时间。订单为 FAILED 时,已经续费成功的资源仍保留新的到期时间。
回调只会在订单第一次进入 COMPLETED 或 FAILED 时发送一次,失败不重试。FAILED 不会自动退款;联系客户支持人工处理后,应重新查询续费订单列表和静态代理资源获取最新结果。
创建请求返回 300320 表示资源价格不存在或与请求规格不匹配;实际 msg 按 X-LANG 返回,省略或不支持时使用 en_US。