FINGER TRADER

دليل تمهيدي للمطورين

دليل البدء باستخدام واجهات Finger Trader

ابدأ من هنا قبل استعراض وثائق المنتجات: تحقق من متطلبات الحساب، وسجّل الدخول للحصول على Access Token، ثم تعرّف على استخدامه في طلبات API التي تتطلب المصادقة.

إطار الوثائق · نظرة عامة

قبل إرسال طلب API

تستخدم واجهات Finger Trader جلسة الحساب لتحديد هوية المستدعي. أكمل متطلبات الحساب وسجّل الدخول قبل استدعاء واجهات الأعمال التي تتطلب المصادقة.

متطلبات الحساب

  • يجب تفعيل حساب Finger Trader الخاص بك.
  • يجب فتح حساب لدى وسيط ضمن منظومة Finger.

1. سجّل الدخول واحصل على Access Token

يستخدم التطبيق OAuth 2.0 password grant للحصول على Access Token من خدمة المصادقة. قيمة type لتسجيل الدخول بالبريد الإلكتروني هي 1، وللهاتف المحمول 2. أرسل captchaId وcaptchaCode فقط عندما تطلب الخدمة CAPTCHA.

نقطة نهاية 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

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 إلى واجهات الأعمال.

ترويسة Authorization
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

3. استدع واجهة Finger Trader BFF API

يرسل تطبيق Flutter طلبات الأعمال بصيغة JSON إلى عنوان BFF API الأساسي، ويضيف ترويسة Authorization للجلسة بعد تسجيل الدخول. تستند المسارات المعروضة هنا إلى تنفيذ التطبيق.

عنوان API الأساسي للإنتاج
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. يرسل المتصفح الطلب مباشرة إلى بيئة Finger Trader الرسمية التي اخترتها.

جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.

الاستجابة
ستظهر الاستجابة هنا.

يبقى Token في ذاكرة هذه الصفحة فقط، ولا يُحفظ في التخزين أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا بعد الضغط على إرسال الطلب، ضمن ترويسة Authorization إلى بيئة API المختارة. امسحه بعد الانتهاء.

إذا أظهر المتصفح خطأ CORS أو شبكة، فقد لا تسمح بيئة API بالطلبات من مصدر هذا الموقع. استخدم عميلاً من جهة الخادم أو أداة API معتمدة؛ ولا تعطل أمان المتصفح.

تم التحقق من DTO تسجيل الدخول وتدفقه وإعداد API ومعترض ترويسة الجلسة المشترك في تطبيق Flutter Finger Trader.