订单
权限：orders:read。
GET /api/v1/orders
Section titled “GET /api/v1/orders”参数：offset、limit、family、status、client_reference（精确匹配）。
未知的 family 或 status 值视为“不筛选”。排序固定且不可配置：最新的在前。
| 字段 | 含义 |
|---|---|
product, kind, family | 购买的内容；kind：resident 或 ipv4 |
quantity | 购买的单位数量：ipv4 为地址数；流量订单始终为 1 - 购买的是一个套餐，流量在 packages[].traffic.purchased_gb 中 |
price_per_proxy, total | 单价（total / quantity）和订单金额；流量订单两者相等 |
status | 见下文 |
applied_to_package_id | 非空 - 订单应用于已有套餐：加购流量或地址续期 |
client_reference | 购买请求体中你的标记 |
packages | 订单交付的流量套餐。加购订单和固定地址订单为空 - 其套餐请通过 GET /api/v1/packages?family=dedicated 读取，详情中有 order_id |
GET /api/v1/orders/{id}
Section titled “GET /api/v1/orders/{id}”格式与列表相同。其他账户的订单返回 404，不带 code 键。
购买在请求内完成，因此 POST /api/v1/packages 的响应中订单已经是
completed。其他状态会在读取订单时出现。
| 状态 | 怎么做 |
|---|---|
pending, provisioning | 每 5-10 秒轮询一次 |
completed | 完成：流量套餐在 packages[0] 中，地址套餐在购买响应的 package_id 中 |
failed | 资金未扣除或已退回，可以重试 |
refunded | 资金已由客服决定退回；请作为新购买重试 |
needs_attention | 资金已扣除，正在人工处理。不要重复购买，请联系客服 |
也可以读取事件日志来代替轮询订单。