指南

流量与账单

购买流量、查看余额，并跟踪钱包记录。

点击接口可编辑请求并查看响应。

区分两种余额

标准流量用于动态代理请求。优化流量是优化动态连接额外使用的额度。优化请求会同时消耗两种余额。

读取 GET/dynamic/account 获取余额快照。标准流量的 total_bytes、used_bytes 和 remaining_bytes 来自同一份报告。null 表示数据暂不可用。不同报告可能在不同时间更新。

GET/dynamic/usage 用于分析指定时段的活动。剩余额度请读取 GET/dynamic/account 的 remaining_bytes。

购买流量包

读取 GET/dynamic/config，选择可用流量包。将其编号作为 pack_id 调用 POST/dynamic/quotes，确认报价后再购买。

调用 POST/dynamic/purchases，将 QUOTE_ID 设为返回的报价编号，并保存请求标识：

PURCHASE_REQUEST_KEY=$(uuidgen)

curl --fail-with-body "$MIGO_API_BASE/dynamic/purchases" \
  -H "Authorization: Bearer $MIGO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $PURCHASE_REQUEST_KEY" \
  -d "{\"quote_id\":\"$QUOTE_ID\"}"

此操作需要写入访问权限、dynamic:write 和 wallet:spend。通过 GET/dynamic/purchases/{id} 跟踪购买结果。已受理不一定表示流量已就绪。

如果激活失败或结果不确定，请保留购买编号并联系支持。不要再次购买来恢复原订单。详见错误与重试。

为钱包充值

你可以直接在工作空间的钱包充值。API 接入可先读取 GET/recharges/config，再创建和跟踪支付。

付款确认后，钱包余额会增加。支付方式与限额以工作空间配置为准。

查看记录

GET/wallet/summary 提供汇总，GET/wallet/ledger 提供已入账流水，GET/order-history 汇总购买记录。大多数列表使用 page 和 page_size 分页，具体限制见API 参考。