開發者入門指南
Finger Trader API 開發入門
閱讀各產品或文件分類前,請先從這裡開始:確認帳戶條件、登入取得 Access Token,並了解如何在需要驗證的 API 請求中使用 Token。
發送 API 請求前
Finger Trader API 會透過帳戶工作階段識別呼叫者。請先完成帳戶開通條件並登入,再呼叫需要驗證的業務 API。
帳戶前置條件
- 你必須已開通 Finger Trader 帳號。
- 你必須已在 Finger 生態中的經紀商處開戶。
1. 登入並取得 Access Token
App 使用 OAuth 2.0 password grant 向認證服務取得 Access Token。電子郵件登入的 type 為 1;手機登入的 type 為 2。只有在服務要求圖形驗證碼時才附上 captchaId 和 captchaCode。
POST https://prod-api.fingertrader.com/finger-auth/oauth2/tokenAuthorization: Basic <APP_CLIENT_CREDENTIALS>
Content-Type: application/x-www-form-urlencodedgrant_type=password
username=<EMAIL_OR_PHONE>
password=<PASSWORD>
type=1 # email; use 2 for mobileFlutter App 會使用其設定的用戶端憑證。本公開文件與瀏覽器 Try it 工具不會提供該憑證。
{
"code": 0,
"data": {
"access_token": "<ACCESS_TOKEN>",
"refresh_token": "<REFRESH_TOKEN>",
"token_type": "Bearer",
"expires_in": 0
},
"msg": ""
}2. 在請求標頭中傳送 Access Token
使用登入回應中的 access_token。App 流程中的 token_type 為 Bearer。不要把 refresh_token 傳給業務 API。
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json3. 呼叫 Finger Trader BFF API
Flutter App 將業務請求送至 BFF API Base URL,使用 JSON 請求本文,登入後會附上工作階段 Authorization 標頭。此處的 API 路徑依 App 用戶端實作整理。
https://prod-api.fingertrader.com/finger-bff-appcurl --request POST 'https://prod-api.fingertrader.com/finger-bff-app/app-api/v1/market/ticker-list' \\
--header 'Authorization: Bearer <ACCESS_TOKEN>' \\
--header 'Content-Type: application/json' \\
--data '{"page":1,"pageSize":10,"query":{"marketType":null,"brokerId":null}}'{
"code": 0,
"data": { "total": 0, "items": [] },
"msg": ""
}試用 API 請求
輸入 Access Token,以及 /app-api/v1 底下的 POST 路徑。瀏覽器會直接向所選的 Finger Trader 官方 API 環境送出請求。
準備就緒。按下「送出請求」前不會傳送任何內容。
回應會顯示在這裡。Token 只保留在此頁面的記憶體中,不會寫入儲存空間,也不會傳送到 Finger Trader 官網伺服器。只有按下「送出請求」後,Token 才會透過 Authorization 標頭傳送至你選擇的 API 環境;完成後請清除。
若瀏覽器顯示 CORS 或網路錯誤,可能是 API 環境未允許此網站來源發送請求。請改用已核準的伺服器端用戶端或 API 工具送出相同請求;不要關閉瀏覽器安全防護。
內容已依 Finger Trader Flutter App 的登入 DTO、登入流程、API 環境設定及共用工作階段標頭攔截器核對。