إنشاء مفتاح WEEX API بأمان: الصلاحيات وربط IP وتشغيل البوتات

دليل إنشاء مفتاح API في منصة WEEX مع الصلاحيات وربط IP للمبتدئين

يمكنك إنشاء مفتاح WEEX API لربط لوحة متابعة أو برنامج ضرائب أو بوت تداول بحسابك، لكن المفتاح ليس مجرد رمز اتصال؛ فالصلاحيات التي تمنحها له تحدد ما يستطيع البرنامج قراءته أو تنفيذه. القاعدة الآمنة هي البدء بصلاحية القراءة فقط، وربط المفتاح بعنوان IP ثابت، ومنح التداول لسوق واحد فقط عندما يحتاج التطبيق إليه فعلًا.

الخلاصة السريعة: أنشئ مفتاحًا مستقلًا لكل أداة، واحفظ APIKey وSecretKey وPassphrase في مدير أسرار، ولا تضعها في كود أو صورة أو محادثة دعم. اختبر الاتصال بالقراءة أولًا، ثم امنح Spot أو Futures عند الضرورة فقط.

ما هو WEEX API ومتى تحتاج إليه؟

واجهة API تسمح لبرنامج خارجي بالتعامل مع بيانات السوق أو معلومات حسابك أو أوامر التداول وفق الصلاحيات التي وافقت عليها. توضح وثائق WEEX للمطورين أن الواجهة تشمل REST وWebSocket لبيانات السوق والحسابات والأوامر والأسواق الفورية والعقود الآجلة.

حالة الاستخدام	الصلاحية المناسبة	الخطر الرئيسي
لوحة أسعار عامة	لا تحتاج مفتاحًا للبيانات العامة	الاعتماد على بيانات أو نطاق خاطئ
متابعة الرصيد أو سجل الصفقات	Read Only	كشف معلومات الحساب عند التسريب
تطبيق ضرائب أو محاسبة	Read Only غالبًا	مشاركة تاريخ مالي مع طرف ثالث
بوت Spot	Read + Spot Trade	أوامر غير مقصودة أو شراء أصل ضعيف السيولة
بوت Futures	Read + Futures/Contract	خسارة سريعة أو تصفية بسبب الرافعة

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

مكونات مفتاح WEEX API

توضح صفحة إنشاء مفتاح API الرسمية أن العملية تنتج ثلاث قيم مختلفة:

القيمة	وظيفتها	طريقة الحماية
APIKey	معرّف المفتاح الذي يرسل مع الطلب	لا يكفي وحده للوصول، لكنه لا يُنشر
SecretKey	توقيع الطلبات الخاصة	يُحفظ سرًا ولا يدخل الواجهة الأمامية أو السجلات
Passphrase	عبارة وصول تختارها عند الإنشاء	لا يمكن استعادتها؛ أنشئ مفتاحًا جديدًا إذا فقدتها

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

طريقة إنشاء مفتاح WEEX API

1. سجّل الدخول إلى WEEX من الموقع الرسمي، ثم افتح Account > API Management.
2. اختر Create API Key وأكمل التحقق الأمني المطلوب في حسابك.
3. اكتب اسمًا يحدد الغرض والجهاز، مثل portfolio-readonly أو spot-bot-vps.
4. أنشئ Passphrase طويلة ضمن المتطلبات الظاهرة واحفظها فورًا؛ لا يمكن استردادها لاحقًا.
5. اترك المفتاح Read Only إن كانت الأداة للمتابعة. أضف Spot أو Futures/Contract فقط إذا كان عليها تنفيذ أو إلغاء أوامر.
6. اربط المفتاح بعنوان IP الثابت للخادم أو الجهاز الذي سيستخدمه.
7. أكمل المصادقة الثنائية، ثم انسخ APIKey وSecretKey واحفظهما في مدير أسرار موثوق.
8. أغلق صفحة الإنشاء بعد التأكد من الحفظ، ولا تلتقط لقطة شاشة تحتوي على المفاتيح.

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

كيف تختار الصلاحية الصحيحة؟

Read Only للمتابعة والتقارير

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

Spot للبوتات الفورية

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

Futures/Contract للعقود الآجلة

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

المفتاح القياسي للمستخدم الذي تشرحه واجهة API Management يركز على القراءة وصلاحيتي تداول Spot وFutures. توجد واجهات منفصلة للوسطاء والحسابات الفرعية بصلاحيات مختلفة؛ لا تنقل إعداداتها إلى مفتاح مستخدم عادي.

لماذا يجب ربط المفتاح بعنوان IP؟

تحذر وثائق إعداد WEEX API من أن المفتاح غير المقيد بعنوان IP يمثل خطرًا أمنيًا. الربط يعني رفض الطلبات التي تأتي من عناوين غير مدرجة، حتى إذا حصل شخص آخر على بيانات المفتاح.

• يقلل قدرة جهة خارجية على استخدام مفتاح مسروق من جهاز مختلف.
• يساعدك على عزل كل بوت في خادم معروف.
• يسهّل تعطيل برنامج واحد دون قطع الأدوات الأخرى.

• العنوان الديناميكي قد يتغير ويوقف الاتصال.
• بعض الخدمات الخارجية لا توفر قائمة IP ثابتة.
• ربط IP لا يحمي من اختراق الخادم المسموح نفسه.

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

طريقة ربط برنامج خارجي دون كشف المفتاح

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

لا تضع المفاتيح في كود الواجهة الأمامية. المتصفح يستطيع كشف متغيرات JavaScript وطلبات الشبكة. يجب أن يبقى SecretKey وPassphrase في خادم أو مخزن أسرار، وأن تُوقَّع الطلبات الخاصة بعيدًا عن المستخدم النهائي.

اختبار الاتصال على مراحل

المرحلة	الاختبار	متى تتوقف؟
البيانات العامة	سعر أو دفتر أوامر دون مفتاح	إذا كان النطاق أو رمز الزوج غير صحيح
قراءة خاصة	استعلام رصيد بمفتاح Read Only	إذا فشل التوقيع أو التوقيت أو IP
أمر غير منفذ	Limit صغير بعيد عن السوق ثم إلغاؤه	إذا لم يظهر متطابقًا في حساب WEEX
تشغيل محدود	حجم صغير وزوج سائل مع حدود يومية	عند تكرار الأخطاء أو اختلاف الحجم
مراقبة	تنبيهات وحالة اتصال وسجل أوامر	عند نشاط غير متوقع أو فقد الاتصال

أخطاء شائعة وحلولها

خطأ في التوقيع أو Passphrase

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

رفض الطلب بسبب الصلاحيات

مفتاح Read Only لا يضع أوامر. تأكد أن البرنامج يستخدم Spot مع صلاحية Spot، أو Futures مع Futures/Contract. لا تضف الصلاحيتين عشوائيًا لمعالجة خطأ في رمز الزوج أو المسار.

رفض الاتصال بعد ربط IP

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

خطأ معدل الطلبات

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

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

قائمة أمان قبل تشغيل بوت حقيقي

• مفتاح مستقل باسم واضح لكل برنامج وجهاز.
• Read Only ما لم يكن التداول ضرورة مثبتة.
• صلاحية سوق واحدة فقط: Spot أو Futures.
• IP ثابت ومدرج في قائمة السماح.
• الأسرار خارج مستودع الكود وملفات السجل.
• حد أقصى لحجم الأمر والخسارة اليومية داخل البرنامج.
• منع تكرار الأمر بعد انقطاع الاتصال دون فحص حالته.
• تنبيه فوري عند فتح مركز أو إلغاء أمر أو توقف البوت.

• نسخ SecretKey داخل دردشة أو مستند مشترك.
• استخدام مفتاح واحد لعدة خدمات غير مترابطة.
• منح Futures لأداة قراءة أو تقارير.
• تشغيل استراتيجية جديدة مباشرة بأموال حقيقية.
• الاعتماد على IP binding وحده دون حماية الخادم والحساب.

ماذا تفعل إذا تسرب المفتاح؟

1. عطّل أو احذف مجموعة API Key من حساب WEEX فورًا.
2. راجع الأوامر المفتوحة والمراكز وسجل التداول والتحويلات.
3. أوقف البرنامج والخادم الذي استخدم المفتاح حتى تعرف سبب التسريب.
4. غيّر كلمات المرور والرموز المرتبطة إذا وُجد احتمال اختراق أوسع، وفعّل 2FA إن لم يكن مفعّلًا.
5. أنشئ مفتاحًا جديدًا بصلاحيات أقل واربطه بعنوان IP بعد معالجة السبب.
6. تواصل مع دعم WEEX عبر القناة الرسمية إذا وجدت نشاطًا غير مصرح به، مع عدم إرسال المفاتيح السرية.

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

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

هل أحتاج مفتاح API لمشاهدة أسعار WEEX؟

لا تحتاج البيانات العامة مثل الأسعار ودفتر الأوامر إلى مصادقة عادةً. المفتاح مطلوب للبيانات الخاصة وإدارة الحساب أو الأوامر.

كم مفتاح API يمكن إنشاؤه في WEEX؟

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

هل يجب منح البوت صلاحية Spot وFutures معًا؟

لا. امنحه السوق الذي يتداول فيه فقط؛ بوت Spot لا يحتاج Futures، وأداة المتابعة قد لا تحتاج أي صلاحية تداول.

ماذا أفعل إذا فقدت Passphrase؟

لا يمكن استعادة Passphrase المفقودة وفق وثائق WEEX. ألغِ مفتاح API القديم وأنشئ مفتاحًا جديدًا، ثم حدّث بيانات الاتصال في البرامج المرتبطة به. احفظ البيانات الجديدة في مكان آمن، واضبط الصلاحيات وربط IP من جديد قبل تشغيل أي بوت.

إعداد WEEX API الآمن يبدأ من أقل صلاحية ممكنة، ومفتاح مستقل لكل أداة، وربط IP، وحفظ الأسرار خارج الكود. لا تجعل سهولة ربط البوت تختصر مرحلة الاختبار؛ خطأ برمجي مع صلاحية تداول قد ينفذ أوامر حقيقية حتى لو تعذر السحب بالمفتاح القياسي.

راجعت خطوات الإنشاء والصلاحيات ومعلومات الحماية من مركز مساعدة WEEX ووثائق المطورين الرسمية في 19 أكتوبر 2026. راجع التوثيق مجددًا قبل الربط لأن المسارات والحدود قد تتغير.