FINGER TRADER

คู่มือเริ่มต้นสำหรับนักพัฒนา

เริ่มต้นพัฒนา 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

ปลายทาง Token สำหรับ Production
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

The Flutter app supplies its configured client credential. It is intentionally not included in this public documentation or browser-based Try it tool.

การตอบกลับ Token (ฟิลด์ที่แอปใช้)
{
  "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
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

3. เรียก Finger Trader BFF API

แอป Flutter ส่งคำขอธุรกิจแบบ JSON ไปยัง URL ฐาน BFF API และเพิ่มเฮดเดอร์ Authorization ของเซสชันเมื่อเข้าสู่ระบบแล้ว เส้นทาง API ในหน้านี้อ้างอิงจากการทำงานของแอป

URL ฐาน API สำหรับ Production
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 และเส้นทาง POST ภายใต้ /app-api/v1 เบราว์เซอร์จะส่งคำขอโดยตรงไปยังสภาพแวดล้อม API อย่างเป็นทางการของ Finger Trader ที่เลือก

พร้อมใช้งาน จะไม่มีการส่งข้อมูลจนกว่าคุณจะกดส่งคำขอ

การตอบกลับ
การตอบกลับจะแสดงที่นี่

Token จะอยู่ในหน่วยความจำของหน้านี้เท่านั้น ไม่บันทึกลงพื้นที่จัดเก็บหรือส่งไปยังเซิร์ฟเวอร์เว็บไซต์ Finger Trader หลังจากกดส่งคำขอเท่านั้น ระบบจึงส่ง Token ในเฮดเดอร์ Authorization ไปยังสภาพแวดล้อม API ที่เลือก โปรดล้าง Token เมื่อใช้งานเสร็จ

หากเบราว์เซอร์แจ้งข้อผิดพลาด CORS หรือเครือข่าย สภาพแวดล้อม API อาจไม่อนุญาตคำขอจากเว็บไซต์นี้ โปรดใช้ไคลเอนต์ฝั่งเซิร์ฟเวอร์หรือเครื่องมือ API ที่ได้รับอนุมัติ อย่าปิดระบบรักษาความปลอดภัยของเบราว์เซอร์

ตรวจสอบกับ DTO และขั้นตอนเข้าสู่ระบบ การตั้งค่าสภาพแวดล้อม API และตัวดักจับเฮดเดอร์เซสชันร่วมของแอป Flutter Finger Trader แล้ว