وثائق API للوسيط
وثائق API للوسيط
تنظم هذه الصفحات واجهات /mer-api/v1 التي يستخدمها Finger Admin في مسارات العملاء والأوامر وإدارة المخاطر. يوفرها Merchant BFF، ويعتمد الوصول على حساب الوسيط والصلاحيات الممنوحة.
وثائق API للوسيط
تنظم هذه الصفحات واجهات /mer-api/v1 التي يستخدمها Finger Admin في مسارات العملاء والأوامر وإدارة المخاطر. يوفرها Merchant BFF، ويعتمد الوصول على حساب الوسيط والصلاحيات الممنوحة.
عنوان Merchant BFF والمصادقة
أرسل طلبات POST بصيغة JSON إلى بيئة Merchant BFF المحددة. يرسل عميل Finger Admin رمز وصول موظف الوسيط المسجل بصيغة Bearer ضمن ترويسة Authorization.
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
تصفح مجموعات API
Customer list
Paged customer search; query keys are based on UserQueryDTO.
/mer-api/v1/customer/listمثال الطلب
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}حقول الطلب
pagenumberpageSizenumberqueryobjectمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل 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.
/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.
/mer-api/v1/order/get-user-order-holding-listمثال الطلب
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}حقول الطلب
pagenumberpageSizenumberqueryobjectمثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل 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.
/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 بعد الانتهاء.