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

View as Markdown

URL القاعدة

https://api.6mm.com

نسخة الخدمة

GET /v1/version

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

وقت الخادم

GET /v1/time

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

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

POST /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"
}'

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

{
"code": 0,
"message": "success",
"data": {
"accessToken": "YOUR_ACCESS_TOKEN",
"accessExpire": 1769676656
},
"requestId": "req-login"
}

رمز تحديث

POST /v1/public/user/refresh-token

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

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

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

العميل SSO

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

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

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

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

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

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

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

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

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

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

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

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

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

GET /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 إذا لم يتم التحقق منه أو لم يتم تصنيفه