คู่มือเริ่มต้นสำหรับนักพัฒนา
เริ่มต้นพัฒนา Finger Trader API
เริ่มจากหน้านี้ก่อนอ่านเอกสารของแต่ละผลิตภัณฑ์ ตรวจสอบเงื่อนไขบัญชี เข้าสู่ระบบเพื่อรับ Access Token และเรียนรู้การใช้ Token กับคำขอ API ที่ต้องยืนยันตัวตน
ก่อนส่งคำขอ API
API ของ Finger Trader ใช้เซสชันบัญชีเพื่อยืนยันผู้เรียก โปรดทำตามเงื่อนไขบัญชีและเข้าสู่ระบบก่อนเรียก API ธุรกิจที่ต้องยืนยันตัวตน
เงื่อนไขบัญชี
- บัญชี Finger Trader ของคุณต้องเปิดใช้งานแล้ว
- คุณต้องเปิดบัญชีกับโบรกเกอร์ในระบบนิเวศ Finger
1. เข้าสู่ระบบและรับ Access Token
แอปใช้ OAuth 2.0 password grant เพื่อรับ Access Token จากบริการยืนยันตัวตน การเข้าสู่ระบบด้วยอีเมลใช้ type 1 และโทรศัพท์มือถือใช้ type 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 ส่งคำขอธุรกิจแบบ JSON ไปยัง URL ฐาน BFF API และเพิ่มเฮดเดอร์ 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 และเส้นทาง POST ภายใต้ /app-api/v1 เบราว์เซอร์จะส่งคำขอโดยตรงไปยังสภาพแวดล้อม API อย่างเป็นทางการของ Finger Trader ที่เลือก
พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ
การตอบกลับจะแสดงที่นี่Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกลงพื้นที่จัดเก็บหรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader หลังจากกดส่งคำขอเท่านั้น ระบบจึงส่ง Token ในเฮดเดอร์ Authorization ไปยังสภาพแวดล้อม API ที่เลือก โปรดล้าง Token เมื่อใช้งานเสร็จ
หากเบราว์เซอร์แจ้งข้อผิดพลาด CORS หรือเครือข่าย สภาพแวดล้อม API อาจไม่อนุญาตคำขอจากเว็บไซต์นี้ โปรดใช้ไคลเอนต์ฝั่งเซิร์ฟเวอร์หรือเครื่องมือ API ที่ได้รับอนุมัติ อย่าปิดระบบรักษาความปลอดภัยของเบราว์เซอร์
ตรวจสอบกับ DTO และขั้นตอนเข้าสู่ระบบ การตั้งค่าสภาพแวดล้อม API และตัวดักจับเฮดเดอร์เซสชันร่วมของแอป Flutter Finger Trader แล้ว