إعداد مفتاح API في WEEX: كيفية ربط منصة خارجية بأمان

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

الربط السريع أم مفتاح WEEX API يدوي: أي الطريقتين تختار؟

استخدم الربط السريع عندما توفره المنصة، واستخدم المفتاح اليدوي في الحالات الأخرى.

الربط السريع هو تفويض OAuth من WEEX، أُعلن عنه في 3 أغسطس 2026. انقر على «تسجيل الدخول باستخدام WEEX» في منصة الشريك، وانتقل إلى صفحة التفويض على WEEX، وراجع الأذونات (يُحدَّد التداول وإمكانية القراءة مسبقًا)، ثم أكّد العملية. بعد ذلك، تنشئ WEEX مفتاح API وترسله إلى الخادم الخلفي للمنصة. لن تتمكن من رؤيته أو نسخه. وتقول WEEX إن العملية تستغرق أقل من ⁦10⁩ ثانية.

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

يعمل المفتاح اليدوي مع أي برنامج يدعم WEEX، بما في ذلك الأدوات التي لا تعمل كوسطاء، ويمنحك تحكمًا كاملًا في الأذونات وربط عناوين IP.

كيفية إنشاء مفتاح WEEX API خطوة بخطوة

1. سجّل الدخول إلى WEEX عبر الويب. انتقل إلى الحساب، ثم إدارة API، واختر إنشاء مفتاح API. تتضمن صفحة WEEX API زر إنشاء API يفتح الشاشة نفسها.
2. سمِّ المفتاح باسم المنصة المخصص لها.
3. أنشئ عبارة مرور باستخدام الأحرف والأرقام فقط. توضح الأسئلة الشائعة لدى WEEX أن الرموز الخاصة غير مقبولة. ولا يمكن استعادة عبارة المرور أو تغييرها لاحقًا.
4. اختر الأذونات. تكون المفاتيح الجديدة مضبوطة افتراضيًا على وضع القراءة فقط (Read Only). أضف إذن التداول الفوري (Spot) أو العقود الآجلة (Futures) فقط إذا كانت المنصة ستنفذ صفقات في ذلك السوق. إذنا التداول مستقلان، لذا لا يحتاج روبوت تداول العقود الآجلة إلى صلاحية الوصول إلى التداول الفوري.
5. اربط عناوين IP إذا كانت المنصة تنشر العناوين التي تتصل منها.
6. أكمل التحقق الأمني.
7. انسخ مفتاح API والمفتاح السري وعبارة المرور، واحفظها في مكان آمن. وتحذّر أدلة الإعداد لدى HaasOnline وKoinX من أن المفتاح السري يُعرض مرة واحدة فقط.

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

ربط المفتاح وتنفيذ أول أمر

تختلف التسميات التي تستخدمها المنصات للقيم الثلاث. وتُعد HaasOnline، التي أضافت WEEX في 22 أغسطس 2026، مثالًا نموذجيًا: افتح Exchange Accounts، واختر التداول الفوري أو العقود الآجلة على WEEX، وأدخل مفتاح API بوصفه المفتاح العام والمفتاح السري بوصفه المفتاح الخاص، ثم أضف عبارة المرور واضغط زر اختبار المفتاح. ويعني كل من «Access key» و«public key» مفتاح API.

قبل تشغيل استراتيجية، نفّذ أمرًا واحدًا يدويًا عبر المنصة:

1. اختر زوج تداول عالي السيولة، وأدخل أصغر حجم تسمح به المنصة كأمر محدد بعيدًا عن السعر الحالي.
2. تحقق من ظهور الأمر ضمن الأوامر المفتوحة على WEEX نفسها.
3. ألغِ الأمر من المنصة وتأكد من اختفائه على WEEX.

تؤكد هذه العملية ذهابًا وإيابًا أن المفتاح والإذن وربط زوج التداول تعمل جميعها، ولا تكلفك شيئًا.

عند فشل العملية، يكون السبب عادةً أحد الأمور التالية:

• الخطأ -1052، أذونات غير كافية. لا يتضمن المفتاح إذن العقود الآجلة، أو أن زوج التداول غير مدعوم.
• أخطاء الأذونات في مفتاح جديد تمامًا. انتظر 15 دقيقة حتى يكتمل التفعيل.
• HTTP 429. ترسل المنصة عددًا كبيرًا جدًا من الطلبات. حد REST لدى WEEX هو 500 وحدة من وزن الطلبات لكل 10 ثوانٍ لكل عنوان IP.
• أخطاء التوقيع أو عبارة المرور. أُدخلت إحدى القيم الثلاث مع حرف ناقص أو مسافة زائدة.
• رفض الطلبات عند تفعيل ربط IP. تتصل المنصة من عنوان غير مدرج في قائمتك.

تسرد الأسئلة الشائعة حول API للعقود الآجلة لدى WEEX رموز الأخطاء كاملةً.

أمان مفتاح WEEX API: 6 إعدادات تحدّ من الأضرار

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

1. امنح أقل قدر من الأذونات. تحتاج أدوات الضرائب وإدارة المحافظ إلى صلاحية القراءة فقط. وتطلب KoinX هذه الصلاحية تحديدًا. ولا يمكن لمفتاح القراءة فقط تنفيذ الأوامر.
2. اربط عناوين IP كلما كانت المنصة تدعم ذلك. تشير وثائق WEEX إلى أن المفاتيح التي لا ترتبط بعناوين IP «تشكل مخاطر أمنية». لا تعمل بعض الخدمات باستخدام قائمة ثابتة. وتطلب KoinX من المستخدمين ترك تقييد IP معطلًا. إذا كانت المنصة تحتاج إلى مفتاح غير مقيّد، فأبقِ ذلك المفتاح للقراءة فقط.
3. استخدم مفتاحًا منفصلًا لكل منصة. مع إمكانية إنشاء ما يصل إلى 10 مجموعات من المفاتيح، لا يوجد سبب لمشاركة مفتاح. يتيح لك المفتاح المنفصل إيقاف خدمة واحدة دون تعطيل بقية الخدمات، كما يساعدك على معرفة أي خدمة تسببت في تسريبه.
4. تعامل مع عبارة المرور باعتبارها سرًا ثالثًا. لا تضعها في لقطات الشاشة أو رسائل الدردشة أو طلبات الدعم. وتوجيهات WEEX واضحة: «لا تشارك عبارة المرور مطلقًا».
5. ارفض طلبات الأذونات التي تتجاوز التداول. تذكر أدلة التكامل أن القراءة فقط والتداول الفوري والعقود الآجلة هي أذونات المفاتيح التي تنشئها. إذا طلبت منصة كلمة مرور تسجيل الدخول إلى WEEX أو صلاحية السحب، فهي تطلب شيئًا لا يحتاج إليه التداول.
6. احذف المفتاح عند الشك. توصي WEEX بحذف المفتاح المخترق فورًا. وافعل الشيء نفسه مع أي منصة توقفت عن استخدامها.

كيفية فصل منصة عن WEEX

أزل المفتاح من داخل المنصة، ثم احذفه من إدارة API لدى WEEX. الخطوة الثانية هي الأهم، لأن المفتاح الذي يُزال من إعدادات المنصة وحدها يظل صالحًا لأي شخص لديه نسخة منه.

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

لا يستغرق ربط منصة بـ WEEX سوى بضع دقائق، لكن الخيارات التي تحددها خلالها ترسم مستوى المخاطر طوال فترة وجود المفتاح: الأذونات الممنوحة، وعناوين IP، وما إذا كان سيتم حذف المفتاح عند عدم الحاجة إليه. تُنشأ المفاتيح وتُدار من صفحة WEEX API.

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

1. كم مفتاح API يمكنني إنشاؤه على WEEX؟

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

2. هل يمكنني إعادة تعيين عبارة مرور WEEX API المفقودة؟

لا. توضح وثائق WEEX أنه لا يمكن استعادة عبارة المرور المفقودة أو تعديلها. احذف المفتاح، وأنشئ مفتاحًا جديدًا بعبارة مرور جديدة، ثم حدّث إعدادات المنصة التي كانت تستخدمه.

3. لماذا يُظهر مفتاح WEEX API الجديد خطأً في الأذونات؟

الأسباب الثلاثة المعتادة هي غياب إذن التداول، أو أن السوق المخصص للمفتاح لا يشمل زوج التداول، أو أن التفعيل لم يكتمل بعد. تقول WEEX إن تفعيل المفاتيح الجديدة أو المعدّلة يستغرق نحو 15 دقيقة، لذا أعد المحاولة بعد ذلك قبل تغيير الإعدادات.

4. هل تدعم WEEX اتصالات TradingView أو FIX؟

تذكر الأسئلة الشائعة حول API للعقود الآجلة لدى WEEX أن تكامل TradingView وFIX API غير مدعومين. وتتم الاتصالات عبر واجهتي REST وWebSocket، إما مباشرةً أو من خلال منصة أدمجتهما.