Hướng dẫn dành cho nhà phát triển
Hướng dẫn bắt đầu với API Finger Trader
Hãy bắt đầu tại đây trước khi xem tài liệu từng sản phẩm: xác nhận điều kiện tài khoản, đăng nhập để nhận Access Token và tìm hiểu cách dùng Token trong các yêu cầu API cần xác thực.
Trước khi gửi yêu cầu API
API Finger Trader xác định người gọi bằng phiên tài khoản. Hãy đáp ứng điều kiện tài khoản và đăng nhập trước khi gọi API nghiệp vụ cần xác thực.
Điều kiện tài khoản
- Tài khoản Finger Trader của bạn phải được kích hoạt.
- Bạn phải mở tài khoản tại một công ty môi giới trong hệ sinh thái Finger.
1. Đăng nhập và nhận Access Token
Ứng dụng dùng OAuth 2.0 password grant để nhận Access Token từ dịch vụ xác thực. Đăng nhập email dùng type 1; đăng nhập điện thoại dùng type 2. Chỉ gửi captchaId và captchaCode khi dịch vụ yêu cầu 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. Gửi Access Token trong header
Dùng access_token trong phản hồi đăng nhập. Luồng ứng dụng sử dụng token_type Bearer. Không gửi refresh_token đến API nghiệp vụ.
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json3. Gọi Finger Trader BFF API
Ứng dụng Flutter gửi yêu cầu nghiệp vụ dạng JSON đến URL cơ sở BFF API và thêm header Authorization của phiên khi đã đăng nhập. Các đường dẫn trong tài liệu dựa trên mã ứng dụng.
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": ""
}Thử yêu cầu API
Nhập Access Token và đường dẫn POST bên dưới /app-api/v1. Trình duyệt gửi trực tiếp đến môi trường API Finger Trader chính thức đã chọn.
Sẵn sàng. Chưa gửi dữ liệu cho đến khi bạn chọn Gửi yêu cầu.
Phản hồi sẽ hiển thị tại đây.Token chỉ nằm trong bộ nhớ của trang này, không được lưu trữ hoặc gửi đến máy chủ website Finger Trader. Token chỉ được gửi trong header Authorization đến môi trường API bạn chọn sau khi nhấn Gửi yêu cầu. Hãy xóa Token khi hoàn tất.
Nếu trình duyệt báo lỗi CORS hoặc mạng, môi trường API có thể chưa cho phép nguồn của website này. Hãy dùng ứng dụng phía máy chủ đã được phê duyệt hoặc công cụ API; không tắt bảo mật trình duyệt.
Đã đối chiếu với DTO đăng nhập, luồng đăng nhập, cấu hình API và interceptor header phiên dùng chung trong ứng dụng Flutter Finger Trader.