API 端點結構
Habittrade 的 API 採用 模組化、版本化 且 市場範圍 的端點結構。這確保了在各種環境和使用場景中提供一致且可擴展的開發體驗。
📍 環境
| 環境 | 說明 | Base URL |
|---|---|---|
| 正式環境 | 實際交易環境 | https://api.habittrade.com |
| UAT（測試環境） | 使用者驗收測試（模擬餘額與交易） | https://api-uat.habittrade.com |
⚠️ API 金鑰與憑證 不會在環境間共用，您需要分別為 UAT 和正式環境生成憑證。
📁 API 路徑結構
所有 API 端點遵循此結構：
{scheme}://{subdomain}/{service}/{version}/{resource}範例：
https://api-uat.habittrade.com/trade/v1/orders✅ URL 段落說明
| 段落 | 範例 | 說明 |
|---|---|---|
{scheme} | https | 一律使用 HTTPS（TLS 1.2+） |
{subdomain} | api.habittrade.com, api-uat.habittrade.com | 環境專用 |
{service} | trade, account, market, auth | 功能模組 |
{version} | v1 | API 版本（支持並行演進） |
{resource} | orders, balances, symbols 等 | 目標功能 |
🧪 UAT 測試環境詳情
- Base URL：
https://api-uat.habittrade.com - 目的：非生產環境，不涉及真實資金
- 功能：支持完整下單、模擬成交、模擬餘額更新
- 使用場景：適用於機器人測試、CI/CD 流程、功能整合
在 UAT 中，訂單 可能無法成交，除非模擬了對應的流動性。請參閱 UAT 測試指南 以查詢測試商品。