開発者向けオンボーディング
Finger Trader API 開発ガイド
製品別ドキュメントを読む前に、まずアカウント要件を確認し、サインインして Access Token を取得し、認証が必要な API リクエストで使用する方法を確認してください。
API リクエストの前に
Finger Trader API はアカウントセッションで呼び出し元を識別します。アカウントの利用条件を満たし、サインインしてから認証が必要な業務 API を呼び出してください。
アカウントの前提条件
- Finger Trader アカウントが有効化されていること。
- Finger エコシステム内のブローカーで口座を開設していること。
1. サインインして Access Token を取得
アプリは OAuth 2.0 password grant で認証サービスから Access Token を取得します。メールログインの type は 1、携帯電話ログインは 2 です。captchaId と captchaCode はサービスから CAPTCHA を求められた場合のみ含めてください。
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 mobileThe Flutter app supplies its configured client credential. It is intentionally not included in this public documentation or browser-based Try it tool.
{
"code": 0,
"data": {
"access_token": "<ACCESS_TOKEN>",
"refresh_token": "<REFRESH_TOKEN>",
"token_type": "Bearer",
"expires_in": 0
},
"msg": ""
}2. リクエストヘッダーに Access Token を設定
サインイン応答の access_token を使用します。アプリのフローでは token_type は Bearer です。refresh_token を業務 API に送信しないでください。
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json3. Finger Trader BFF API を呼び出す
Flutter アプリは業務リクエストを BFF API Base URL に JSON で送信し、サインイン中は Authorization セッションヘッダーを付与します。掲載した API パスはアプリの実装に基づいています。
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 ウェブサイトサーバーへの送信は行いません。「リクエストを送信」を押した後、選択した API 環境に Authorization ヘッダーとして送信されます。完了後に消去してください。
CORS またはネットワークエラーが表示された場合、このウェブサイトからのリクエストが API 環境で許可されていない可能性があります。承認済みのサーバー側クライアントまたは API ツールを使用してください。ブラウザーのセキュリティを無効にしないでください。
Flutter アプリのログイン DTO、ログイン処理、API 環境設定、共通セッションヘッダー処理を照合しました。