دليل تمهيدي للمطورين
دليل البدء باستخدام واجهات 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.
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 إلى واجهات الأعمال.
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json3. استدع واجهة Finger Trader BFF API
يرسل تطبيق Flutter طلبات الأعمال بصيغة JSON إلى عنوان BFF API الأساسي، ويضيف ترويسة Authorization للجلسة بعد تسجيل الدخول. تستند المسارات المعروضة هنا إلى تنفيذ التطبيق.
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. يرسل المتصفح الطلب مباشرة إلى بيئة Finger Trader الرسمية التي اخترتها.
جاهز. لن يُرسل شيء حتى تضغط على إرسال الطلب.
ستظهر الاستجابة هنا.يبقى Token في ذاكرة هذه الصفحة فقط، ولا يُحفظ في التخزين أو يُرسل إلى خوادم موقع Finger Trader. لا يُرسل إلا بعد الضغط على إرسال الطلب، ضمن ترويسة Authorization إلى بيئة API المختارة. امسحه بعد الانتهاء.
إذا أظهر المتصفح خطأ CORS أو شبكة، فقد لا تسمح بيئة API بالطلبات من مصدر هذا الموقع. استخدم عميلاً من جهة الخادم أو أداة API معتمدة؛ ولا تعطل أمان المتصفح.
تم التحقق من DTO تسجيل الدخول وتدفقه وإعداد API ومعترض ترويسة الجلسة المشترك في تطبيق Flutter Finger Trader.