FINGER TRADER

開發者入門指南

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。

正式環境 Token 端點
POST https://prod-api.fingertrader.com/finger-auth/oauth2/token
請求標頭
Authorization: Basic <APP_CLIENT_CREDENTIALS>
Content-Type: application/x-www-form-urlencoded
表單欄位
grant_type=password
username=<EMAIL_OR_PHONE>
password=<PASSWORD>
type=1  # email; use 2 for mobile

Flutter App 會使用其設定的用戶端憑證。本公開文件與瀏覽器 Try it 工具不會提供該憑證。

Token 回應(App 使用的欄位)
{
  "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 標頭
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

3. 呼叫 Finger Trader BFF API

Flutter App 將業務請求送至 BFF API Base URL,使用 JSON 請求本文,登入後會附上工作階段 Authorization 標頭。此處的 API 路徑依 App 用戶端實作整理。

正式環境 API Base URL
https://prod-api.fingertrader.com/finger-bff-app
POST /app-api/v1/market/ticker-list
curl --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 環境設定及共用工作階段標頭攔截器核對。