# 傳送第一個請求

建立工作空間 API 金鑰，用唯讀請求驗證接入。

## 建立金鑰

開啟[工作空間的 API 金鑰頁面](https://portal.migoip.com/app/api-keys)，為你的應用建立金鑰。金鑰只展示一次，請立即儲存。

第一個請求只需要唯讀存取與 `account:read`。按需要新增權限，並設定到期時間、允許存取的 IP 範圍或支出限額。

## 確認工作空間

呼叫 `GET /account` 確認工作空間。在本機環境設定 `MIGO_API_KEY`，然後執行：

```sh
export MIGO_API_BASE='https://portal.migoip.com/api/customer/v1'

curl --fail-with-body "$MIGO_API_BASE/account" \
  -H "Authorization: Bearer $MIGO_API_KEY"
```

成功回應會回傳金鑰所屬的工作空間。無需在請求中新增工作空間 ID，也不需要瀏覽器登入工作階段。

## 選擇權限

| 操作 | 權限 |
| --- | --- |
| 檢視靜態價格 | `catalog:read` |
| 檢視靜態資源 | `proxies:read` |
| 檢視連線憑證 | `credentials:read` 及對應代理權限 |
| 建立靜態訂單 | `orders:write`、`wallet:spend` |
| 購買動態流量 | `dynamic:write`、`wallet:spend` |
| 檢視動態設定和流量 | `dynamic:read` |

寫入操作還需要金鑰具有寫入存取權限。每個端點會列出完整的所需權限。新建唯讀金鑰預設不包含憑證讀取權限。

支出限額限制該金鑰累計從錢包扣除的金額，退款不會恢復限額。設定了支出限額的金鑰不能開啟自動續費。

## 妥善儲存金鑰

在伺服器或可信的本機工具中使用金鑰，不要寫入公開網站、程式碼儲存庫或共享記錄。金鑰遺失後，請撤銷並重新建立。

接下來可以[購買靜態代理](/zh-tw/docs/guides/static-proxies)或[產生動態連線](/zh-tw/docs/guides/dynamic-proxies)。