# 流量與帳單

購買流量、檢視餘額，並跟蹤錢包記錄。

## 區分兩種餘額

**標準流量**用於動態代理請求。**最佳化流量**是最佳化動態連線額外使用的額度。最佳化請求會同時消耗兩種餘額。

讀取 `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-tw/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-tw/docs/api)。