# 流量与账单

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

## 区分两种余额

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

读取 `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` 设为返回的报价编号，并保存请求标识：

```sh
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}` 跟踪购买结果。已受理不一定表示流量已就绪。

如果激活失败或结果不确定，请保留购买编号并联系支持。不要再次购买来恢复原订单。详见[错误与重试](/zh-cn/docs/guides/errors-and-retries)。

## 为钱包充值

你可以直接在[工作空间的钱包](https://portal.migoip.com/app/wallet)充值。API 接入可先读取 `GET /recharges/config`，再创建和跟踪支付。

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

## 查看记录

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