介紹 Admin APIs

最後更新：2026年8月26日1 分鐘閱讀

儀表板對於管理單一 app 來說已經很夠用。但對於大規模使用 Alchemy 的團隊,像是為每個客戶、每個合作夥伴、或每個環境都建立專屬 app 的情況,就會產生大量重複性工作。每次都要點同樣的建立流程、更新 allowlist、檢查用量。

因此,我們很高興開放兩個 Admin APIs,讓開發者的工作更簡單、更流暢:

Apps Management API: 建立、設定、刪除 app,管理 allowlist。
Usage API: 取得與儀表板 Usage 頁籤相同的用量數據。

這兩個 API 都可透過同一個 endpoint、同一組 Access Key 存取。從儀表板的 Settings → Security 取得一組 Access Key,設定權限範圍為 App Management 或 Usage,指向 https://admin-api.alchemy.com/v1 即可。

Apps Management API

Apps Management API 處理原本需要在儀表板手動操作的 CRUD:建立 app、設定其 network allowlist,並管理其 address、domain、IP allowlist。

bashCopied
curl -X POST 'https://admin-api.alchemy.com/v1/apps' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your access key}' \
--data '{
  "name": "app-tenant-42",
  "networkAllowlist": ["ETH_MAINNET"],
  "products": ["node-api"]
}'

這取代了原本需要手動處理的情境:為每個客戶建立專屬 app 的平台、為每個合作夥伴或節點營運商建立獨立 app 以隔離用量的團隊,或是為每個環境都建立新 app 的 pipeline。Access Key 本身帶有各自的權限範圍、到期時間與輪換機制,因此 app 的建立流程可以整合進 CI/CD,而不必只能在儀表板上手動操作。

Usage API

Usage API 是一個唯讀的 endpoint,提供原本需要從儀表板 Usage 頁籤取得的數據:總體及依 network 劃分的 CUs,以及本月累計數據;付費方案還可取得依 app、method、network 劃分的細項,涵蓋 HTTP、WebSocket、webhook 流量、以美元計價的用量,以及請求數量。

bash

Copied

curl 'https://admin-api.alchemy.com/v1/usage/summary' \
--header 'Authorization: Bearer {your access key}'

歷史資料範圍與細節程度依方案而異:

Plan	What's included
Free	High-level CU summary, 1 day of history
PAYG	Full breakdown, 7 days of history
Enterprise	Full breakdown, 30 days of history

以下兩種憑證皆可作為 bearer token 進行驗證:設定為唯讀 Usage 權限的 Access Key,可取得整個團隊的數據;或者,如果只需要單一 app 的數據,也可使用既有的 app-scoped API key,傳遞方式相同。

開始使用

從 Security 頁籤建立一組 Access Key,設定所需的權限範圍,然後呼叫 https://admin-api.alchemy.com/v1。

深入閱讀文件,如有任何問題或想討論大規模使用的專屬解決方案,歡迎聯絡我們的團隊。

FAQ

Apps Management 和 Usage 有什麼差別?

Apps Management 用於建立與設定 app:名稱、network allowlist,以及 address、domain、IP allowlist。Usage 則是唯讀的,回傳 compute unit 總量,付費方案還可取得依時間序列劃分的細項。請將 Access Key 的權限範圍限制在實際需要的權限即可。