كيف تصبح وسيطًا لدى WEEX: التقديم وإعداد API وبدء التشغيل

لتصبح وسيطًا لدى WEEX، أرسل نموذج الانضمام المرتبط من صفحة الوسطاء لدى WEEX، واجتز مراجعة العناية الواجبة، واحصل على معرّف وسيط بالتنسيق WEEX متبوعًا بستة أرقام. بعد ذلك، يصبح العمل تقنيًا: اربط المستخدمين عبر OAuth أو مفاتيح API الخاصة بهم، وأضف معرّف الوسيط إلى بداية كل طلب، وطابق العمولات عبر واجهات نقاط نهاية الخصومات. تحدد WEEX يوم عمل واحدًا للموافقة وأربعة إلى خمسة أيام عمل لبدء التشغيل. تتبع الأقسام أدناه هذا التسلسل، وتوضح ما ينبغي تجهيزه، وتتناول إجراءات الأمان اللازمة عند الاحتفاظ بمفاتيح الآخرين. المعلومات محدثة حتى 7 أكتوبر 2026.

من يمكنه التقديم وما الذي تطلبه WEEX

يمكن للأفراد والفرق والشركات التقديم، ولا يلزم إيداع أي مبلغ. وتذكر الأسئلة الشائعة في صفحة WEEX Broker أن فرق التداول الكمي والمؤسسات المالية وقادة الرأي الرئيسيين في المجتمعات (KOLs) من المتقدمين المرحب بهم، وتصف المراجعة بأنها إجراء اعتيادي للعناية الواجبة.

النموذج هو الجزء السهل. يتطلب التسجيل عبر OAuth الذي يليه معلومات أكثر، وجمعها مبكرًا يوفر عليك أيامًا:

• اسم المنصة باللغة الإنجليزية
• معرّف WEEX UID الذي سيرتبط بهوية الوسيط
• روابط سياسة الخصوصية وشروط الخدمة
• شعار المنصة
• اسم شخص للتواصل وعنوان بريده الإلكتروني
• عنوان URL واحد أو أكثر لعمليات إعادة الاتصال
• عناوين IP العامة التي ترسل منها خوادمك الطلبات

هناك نقطتان تفاجئان بعض الفرق. يجب أن يكون لديك حساب WEEX قبل التقديم، لأن UID جزء من التسجيل. كما يجب أن تكون سياسة الخصوصية وشروط الخدمة منشورتين على صفحات فعالة.

الجدول الزمني للتقديم إلى WEEX Broker: من النموذج إلى معرّف الوسيط

1. أرسل النموذج. يفتح زر «Apply now» في صفحة الوسطاء النموذج.
2. انتظر المراجعة. تعد صفحة الوسطاء بالتواصل خلال 24 ساعة وبـ«الموافقة خلال يوم عمل واحد». وتذكر مقدمة Broker API أن فريق تطوير الأعمال يراجع الطلبات خلال ثلاثة أيام عمل. ضع في الحسبان المدة الأطول.
3. استلم رسالة الموافقة الإلكترونية. تتضمن معرّف وسيط مثل WEEX123456، والإعداد الأولي لمعدل عمولتك، وإمكانية الوصول إلى مجموعة الدعم الفني.
4. احصل على بيانات اعتماد OAuth. بعد أن تسجل WEEX عناوين URL لعمليات إعادة الاتصال وعناوين IP الخاصة بك، ستتلقى clientId ومفتاحًا سريًا.
5. أدمج الخدمة وابدأ التشغيل. يحدد إعلان WEEX الصادر في ⁦07/2026⁩ موعدًا للتكامل التقني من اليوم الثاني إلى اليوم الرابع، وللإطلاق في اليوم الخامس.

عمليًا، يتوقف الجدول الزمني بدرجة أقل على مراجعة WEEX وبدرجة أكبر على سرعة توفيرك لعناوين URL ثابتة لعمليات إعادة الاتصال وعناوين IP صادرة ثابتة.

ربط المستخدمين: تدفق OAuth لدى WEEX في سبع خطوات

يتيح OAuth للمستخدم تفويض منصتك عبر صفحة WEEX نفسها، ثم يعيد مفتاح API جاهزًا إلى خادمك الخلفي. يحدد دليل تكامل OAuth التدفق كما يلي.

1. أنشئ على خادمك الخلفي قيمة state تُستخدم مرة واحدة، بطول يتراوح بين 22 و128 حرفًا، وcode_verifier لـ PKCE بطول على الأقل ⁦43⁩. احسب التحدي باستخدام Base64URL(SHA256(code_verifier)). طريقة S256 هي الوحيدة المقبولة.
2. أعِد توجيه المستخدم إلى https://www.weex.com/ar/oauth مع clientId وresponseType=code وscope=create:apikey وقيمة state وredirectUri الخاص بك وتحدي الرمز.
3. يراجع المستخدم الطلب ويوافق عليه على WEEX.
4. تعيد WEEX توجيه المستخدم إلى عنوان إعادة الاتصال الخاص بك مع code وstate. تحقق من تطابق state مع القيمة التي أصدرتها.
5. أرسل من الخادم الخلفي طلب POST إلى https://gateway.weex.com/v1/oauth/token مع code وredirectUri وcode verifier. يتضمن الطلب ترويسات Client-Id وSign وTimestamp وNonce، حيث تكون Sign عبارة عن HMAC-SHA256 مرمّز بـ Base64 للطابع الزمني وnonce والطريقة والمسار ونص الطلب، باستخدام المفتاح السري الخاص بك.
6. استلم رمز وصول صالحًا لمدة 3,600 ثانية ورمز تحديث صالحًا لمدة 36,000 ثانية. يؤدي تحديث الرمز إلى إبطال رمز الوصول السابق.
7. أرسل طلب POST إلى https://gateway.weex.com/v1/oauth/resource/create-api باستخدام رمز bearer. يتضمن الرد apiKey وsecret وpassphrase الخاص بالمستخدم، وتُعاد هذه البيانات مرة واحدة فقط.

هناك ثلاثة قيود تؤثر في التصميم. لا يمكن للمستخدم الاحتفاظ إلا بمفتاح API واحد مرتبط بمنصة خارجية محددة، وتؤدي المحاولة الثانية إلى الخطأ 81001، «api key already bound». كما تُحظر الطلبات الواردة من عناوين IP لم تسجلها. وإذا لم تكن حالة API لدى المستخدم طبيعية، فقد لا يعمل المفتاح الجديد فورًا، لذا يجب أن توفر واجهتك حالة انتظار.

استخدام OAuth اختياري. يمكن للمنصة قبول المفاتيح التي ينشئها المستخدمون ويلصقونها بأنفسهم. أما إضافة الوسم إلى الطلبات، الموضحة أدناه، فهي مطلوبة في كلا المسارين.

إضافة الوسم إلى الطلبات والتحقق من أهلية العمولة

يجب أن يبدأ معرّف طلب العميل لكل طلب بمعرّف الوسيط: يجب أن تبدأ newClientOrderId بـ b-{brokerId}، مثل b-WEEX123456-20260319001. تنطبق هذه القاعدة على التداول الفوري والعقود الآجلة.

من السهل إغفال نقطتين. معرّف طلب العميل اختياري في نقطة نهاية طلبات التداول الفوري، وتعيّن WEEX معرّفًا إذا لم تضفه. لن يتضمن الطلب المرسل بهذه الطريقة بادئة الوسيط، لذا أدرج هذا الحقل في كل طلب. وهناك أيضًا تعارض في حدود الطول: تسمح مقدمة الوسطاء بـ 64 حرفًا، بينما تحدد نقطة نهاية طلبات العقود الآجلة نطاقًا من 1 إلى 36. تستخدم البادئة b-WEEX123456- 13 حرفًا. وتصميم بقية المعرّف بحيث لا يتجاوز 23 حرفًا متبقيًا يجعله متوافقًا مع كلا الحدين.

بعدها، استخدم نقاط النهاية الثلاث في Broker rebate API:

• الأهلية. تقبل GET /api/v3/apiReferral/checkUserEligibility معرّف WEEX UID، وتُرجع ما إذا كان المستخدم مؤهلًا، والسبب، وما إذا كان الحساب مرتبطًا بالفعل برمز إحالة آخر. استدعها عند ربط المستخدم، وخزّن النتيجة، واستبعد المستخدمين غير المؤهلين من توقعات العمولات.
• المعدلات. تُرجع GET /api/v3/apiReferral/rebateRatio فئتك (BRONZE أو SILVER أو GOLD) وست نسب: نسب التداول الفوري والعقود الآجلة للمحالين المباشرين، وللمستخدمين الذين لا يملكون رمز إحالة، ولإحالات «Invite Friends».
• السجلات. تُرجع GET /api/v3/apiReferral/rebate/recentRecord سجلات العمولات حسب الرمز وعملة العمولة، للتداول الفوري SPOT افتراضيًا أو للعقود الآجلة FUTURES. الحد الأقصى لنطاق البحث هو 90 يومًا، والحد الأقصى لحجم الصفحة هو 100.

تُعاد السجلات لكل رمز وفترة تسوية، وتتضمن حقولًا للمبلغ المتداول والرسوم وخصم الرسوم ومعدل الخصم والعمولة. لكنها لا تتضمن معرّف مستخدم أو معرّف طلب. لتقسيم العمولة حسب المستخدم، مثلًا عند مشاركة الإيرادات مع مؤلفي الاستراتيجيات، احتفظ بسجل طلبات خاص بك، مستخدمًا معرّف طلب العميل مفتاحًا. وتذكر صفحة الوسطاء أن تسوية العمولات تتم يوميًا.

أمان مفاتيح API للوسطاء: الاحتفاظ بمفاتيح الآخرين

بمجرد ربط أول مستخدم لحسابه، ستحتوي قاعدة بياناتك على بيانات اعتماد تتيح تداول أموال حقيقية. تحدد وثائق WEEX الحد الأدنى من متطلبات الأمان، وعلى الوسيط الحريص أن يتجاوزها.

• احتفظ بالأسرار في الخادم الخلفي. ينص دليل OAuth على ضرورة عدم ظهور سر العميل وcode verifier والمفتاح السري وpassphrase الخاصين بكل مستخدم في شيفرة الواجهة الأمامية مطلقًا. وتضيف الأسئلة الشائعة للوسطاء أنه ينبغي عدم تمرير المفاتيح والأسرار وعبارات المرور في معاملات URL مطلقًا. بعد إعادة الاتصال، أعد التوجيه إلى صفحة نظيفة ودع الواجهة الأمامية تجلب الحالة.
• شفّر المفاتيح المخزنة وأخفِها في السجلات. يُعد سجل تصحيح أخطاء يتضمن سرًا كاملًا الطريقة الأكثر شيوعًا لتسرب المفاتيح من أنظمة سليمة فيما عدا ذلك.
• ثبّت عناوين IP الصادرة لديك. تحظر WEEX الطلبات الواردة من عناوين غير مسجلة. وقد يؤدي تغيير المناطق السحابية أو إضافة وكيل دون تحديث التسجيل إلى انقطاع الخدمة عن جميع المستخدمين دفعة واحدة.
• استعد لإعادة البيانات لمرة واحدة. إذا فشلت الكتابة إلى التخزين بعد نجاح create-api، فسيضيع السر وسيضطر المستخدم إلى حذف المفتاح وإعادة الربط. اجعل هذه الخطوة معاملة واحدة.
• اطلب أقل قدر من الصلاحيات. في مسار الحساب الفرعي، يتطلب أي مفتاح يتجاوز صلاحية القراءة فقط قائمة سماح لعناوين IP تضم حتى 10 إدخالات. لا تطلب صلاحية TRANSFER أو WITHDRAW إلا إذا كان المنتج ينقل الأموال.
• التزم بالحدود. تتشارك طلبات REST حدًا قدره 500 وحدة وزن لكل 10 ثوانٍ. خفّف معدل الطلبات عند تلقي HTTP 429، وأرسل تنبيهًا عند تكرار إخفاقات التفويض، فقد يشير ذلك إلى اختبار بيانات اعتماد مسرّبة.

قائمة التحقق قبل بدء التشغيل مع أول مستخدم حقيقي

• نفّذ المسار كاملًا على حساب تجريبي: الربط، وظهور نتيجة أهلية صحيحة، وتنفيذ طلب يحمل الوسم، ثم ظهور التداول في سجل العمولات بعد التسوية التالية.
• تحقق من فئتك ونسبك عبر نقطة نهاية المعدلات بدلًا من افتراض صحة الرقم المعلن.
• اختبر تنسيق معرّف طلب العميل في كل من التداول الفوري والعقود الآجلة.
• أعِد إرسال قيمة state قديمة ورمز تفويض مستخدم. ينبغي أن يفشل كلاهما.
• جرّب إرسال طلب من عنوان IP غير مسجل. ينبغي حظره.
• استخدم نقاط النهاية التجريبية ضمن المسار /sim/، الموضحة في الأسئلة الشائعة حول واجهة API للعقود الآجلة لدى WEEX، لاختبار منطق الطلبات دون أموال حقيقية.
• أعد دليل إجراءات الدعم. تذكر وثائق WEEX العنوان support@weex.com ومجتمع Telegram، كما تتضمن الموافقة الانضمام إلى مجموعة دعم فني.

يتطلب أن تصبح وسيطًا لدى WEEX تقديم نموذج واجتياز مراجعة قصيرة. أما الحصول على مستحقاتك على نحو صحيح فيتطلب إضافة وسوم دقيقة إلى الطلبات، والتحقق من أهلية كل مستخدم، وتشغيل مهمة مطابقة يومية. يبدأ التقديم من صفحة WEEX Broker.

الأسئلة الشائعة

1. كم تستغرق الموافقة لتصبح وسيطًا لدى WEEX؟

تعد صفحة الوسطاء لدى WEEX بالتواصل خلال 24 ساعة والموافقة خلال يوم عمل واحد. وتذكر وثائق API أن فريق تطوير الأعمال يراجع الطلبات خلال ثلاثة أيام عمل. ثم يستغرق التكامل التقني نحو أربعة إلى خمسة أيام عمل، وفقًا لإعلان WEEX الصادر في ⁦07/2026⁩.

2. هل يتطلب أن تصبح وسيطًا لدى WEEX أي تكلفة؟

لا. تذكر صفحة الوسطاء أنه لا يلزم إيداع أي مبلغ، وأن بدء العمل لا يكلف شيئًا. يخضع المتقدمون لإجراء اعتيادي للعناية الواجبة، ويحصل الوسطاء المعتمدون على إمكانية الوصول مجانًا إلى الواجهة الخلفية للوسطاء ولوحة بياناتهم.

3. كيف يبدو معرّف الوسيط لدى WEEX؟

يتكون من كلمة WEEX متبوعة بستة أرقام، مثل WEEX123456، ويصل في رسالة الموافقة الإلكترونية. يجب أن يبدأ معرّف طلب العميل لكل طلب ترسله المنصة بالبادئة b- متبوعة بذلك المعرّف.

4. هل يمكن للمنصة التكامل مع WEEX Broker من دون OAuth؟

نعم. يمكن للمستخدمين إنشاء مفاتيح API على WEEX وإدخالها يدويًا على المنصة. يلغي OAuth هذه الخطوة اليدوية، بينما تعمل نقاط نهاية إضافة الوسوم إلى الطلبات والعمولات بالطريقة نفسها في كلا المسارين.