نقاط النهاية العامة

View as Markdown

URL القاعدة

https://api.6mm.com

نسخة الخدمة

1GET /v1/version

احصل على معلومات عن إصدار الخدمة.

وقت الخادم

1GET /v1/time

احصل على وقت الخادم. يمكن استخدام هذه النقطة النهائية لمعايرة وقت العميل قبل توقيع API Key .

تسجيل دخول المستخدم

1POST /v1/public/user/login

معايير الطلب:

المعلمةالنوعمطلوبالوصف
usernamestringنعماسم المستخدم، الطول من 3 إلى 32
passwordstringنعمكلمة السر، الطول 1 - 64
deviceIdstringلابصمة الجهاز، حتى 64 حرفا
deviceNamestringلااسم الجهاز، حتى 128 حرفا

مثال على الطلب:

$curl -X POST https://api.6mm.com/v1/public/user/login \
> -H "Content-Type: application/json" \
> -d '{
> "username": "alice",
> "password": "yourPassword",
> "deviceId": "device-001",
> "deviceName": "server-001"
> }'

مثال على الرد:

1{
2 "code": 0,
3 "message": "success",
4 "data": {
5 "accessToken": "YOUR_ACCESS_TOKEN",
6 "accessExpire": 1769676656
7 },
8 "requestId": "req-login"
9}

رمز تحديث

1POST /v1/public/user/refresh-token

في سيناريوهات التكامل العادية، يتم تحديث حالة تسجيل الدخول عبر كوكي. احتفظ بالكوكي الذي أعادته عبر رد تسجيل الدخول.

حقول الاستجابة:

الميدانالنوعالوصف
accessTokenstringرمز الوصول الجديد
accessExpireint64وقت انتهاء صلاحية رمز الوصول

العميل SSO

تبادل التذاكر

1POST /v1/public/agent-sso/exchange-ticket

معايير الطلب:

المعلمةالنوعمطلوبالوصف
ticketstringنعمتذكرة لمرة واحدة صادرة من خدمة الوكيل
deviceIdstringلابصمة الجهاز، حتى 64 حرفا

حقول الاستجابة:

الميدانالنوعالوصف
accessTokenstringرمز الوصول
accessExpireint64وقت انتهاء صلاحية رمز الوصول
redirectPathstringمسار إعادة التوجيه المقترح

تبادل الرموز المضمنة

1POST /v1/public/agent-sso/exchange-embed-token

معايير الطلب:

المعلمةالنوعمطلوبالوصف
embedTokenstringنعمرمز تداول مدمج قصير العمر يصدره خدمة الوكلاء
channelIdstringنعممعرف قناة iframe مدمج، حتى 128 حرفا
deviceIdstringلابصمة الجهاز، حتى 64 حرفا

حقول الاستجابة:

الميدانالنوعالوصف
accessTokenstringرمز الوصول
accessExpireint64وقت انتهاء صلاحية رمز الوصول

لوحة المتصدرين في PnL

1GET /v1/public/leaderboard/pnl?period=30d

معايير الطلب:

المعلمةالنوعمطلوبالوصف
periodstringنعم7d / 30d / 90d

حقول الاستجابة:

الميدانالنوعالوصف
list[].rankint32الرتبة
list[].userIdstringمعرف المستخدم الخارجي
list[].traderstringاسم تاجر مقنع
list[].volumestringحجم التداول في النافذة
list[].pnlAmountstringتم تحقيق PnL في النافذة
list[].pnlPctstringنسبة PnL، عشرية من 0 إلى 1
myRankint32ترتيب المستخدم الحالي. يعيد 0 إذا لم يتم التحقق منه أو لم يتم تصنيفه