FINGER TRADER

وثائق API للوسيط

وثائق API للوسيط

تنظم هذه الصفحات واجهات /mer-api/v1 التي يستخدمها Finger Admin في مسارات العملاء والأوامر وإدارة المخاطر. يوفرها Merchant BFF، ويعتمد الوصول على حساب الوسيط والصلاحيات الممنوحة.

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

وثائق API للوسيط

تنظم هذه الصفحات واجهات /mer-api/v1 التي يستخدمها Finger Admin في مسارات العملاء والأوامر وإدارة المخاطر. يوفرها Merchant BFF، ويعتمد الوصول على حساب الوسيط والصلاحيات الممنوحة.

تتطلب هذه الواجهات جلسة موظف وسيط موثقة وصلاحيات backend المناسبة. لا يصادق Token مستخدم تطبيق التداول العادي على هذه الواجهات. تحقق من الصلاحيات مع مسؤول الوسيط.

عنوان Merchant BFF والمصادقة

أرسل طلبات POST بصيغة JSON إلى بيئة Merchant BFF المحددة. يرسل عميل Finger Admin رمز وصول موظف الوسيط المسجل بصيغة Bearer ضمن ترويسة Authorization.

https://dev-api.fingertrading.com/finger-bff-merchant
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>

تصفح مجموعات API

Customer list

Paged customer search; query keys are based on UserQueryDTO.

POST/mer-api/v1/customer/list

مثال الطلب

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

حقول الطلب

pagenumber
pageSizenumber
queryobject

مثال الاستجابة

القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
جرّب هذا الطلب · /mer-api/v1/customer/list

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

الاستجابة
—

يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.

Market order pool

Queries the market order pool using MarketQueryDTO.

POST/mer-api/v1/order/market-order-list

مثال الطلب

{
  "marketType": 0
}

حقول الطلب

marketTypenumber

مثال الاستجابة

القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
جرّب هذا الطلب · /mer-api/v1/order/market-order-list

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

الاستجابة
—

يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.

Customer open positions

Paged customer holdings query.

POST/mer-api/v1/order/get-user-order-holding-list

مثال الطلب

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

حقول الطلب

pagenumber
pageSizenumber
queryobject

مثال الاستجابة

القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
جرّب هذا الطلب · /mer-api/v1/order/get-user-order-holding-list

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

الاستجابة
—

يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.

User matching configuration

Reads the matching configuration for a market/user context.

POST/mer-api/v1/trade/user-match-config

مثال الطلب

{
  "marketType": 0
}

حقول الطلب

marketTypenumber

مثال الاستجابة

القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
جرّب هذا الطلب · /mer-api/v1/trade/user-match-config

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

الاستجابة
—

يُستخدم Token في جلسة الصفحة الحالية فقط ولا تحفظه صفحة الوثائق. تجنب الأجهزة المشتركة وامسح Token بعد الانتهاء.