مفاتيح API هي ما يتيح لـ Freya تنفيذ الصفقات على منصتك نيابةً عنك. بمجرد ربط منصة، تجتمع كل مفاتيحك في مكان واحد حيث يمكنك مراجعتها، ورؤية ما يُسمح لكل مفتاح بفعله بالضبط، وإضافة المزيد، أو حذف تلك التي لم تعد تستخدمها. يشرح هذا الدليل كيفية إدارتها.
إذا كنت تربط منصة للمرة الأولى، فابدأ بـ كيفية ربط منصتك. أما هذا المقال فيتناول إدارة المفاتيح التي أضفتها بالفعل.
أهم النقاط
- تجتمع كل مفاتيح API المرتبطة بمنصتك في الإعدادات ← مفاتيح API، مع عرض المنصة، وتسمية لكل مفتاح، وتاريخ إضافته، وحالته.
- يعرض كل مفتاح صلاحياته، وهي القراءة والتداول و(بالنسبة للعقود الآجلة) صلاحية Futures، حتى ترى بالضبط ما يتيحه.
- يمكنك إضافة مفتاح آخر في أي وقت، أو حذف مفتاح لم تعد تستخدمه.
- لن تحذف Freya مفتاحاً ما دام هناك بوت يستخدمه، فأوقف تلك البوتات أو ألبثها أولاً. الحذف لا يمكن التراجع عنه، وتصلك رسالة كلما تمت إزالة مفتاح.
- تُخزَّن بيانات اعتماد API الخاصة بك مشفَّرة، ولا تحتاج Freya أبداً إلى صلاحية السحب على مفاتيحك.
نظرة سريعة على الخطوات
- افتح قائمة مفاتيحك: انتقل إلى الإعدادات ← مفاتيح API لرؤية كل منصة مرتبطة، مع تسميتها وتاريخ إضافتها وحالتها.
- تحقق من صلاحيات كل مفتاح: تأكد من أنه يعرض القراءة والتداول (وFutures إن كنت تتداول العقود الآجلة)، ولا يعرض أبداً صلاحية السحب.
- أضف مفتاحاً عند الحاجة: استخدم إضافة مفتاح API لربط منصة أخرى أو مفتاح إضافي، متّبعاً الخطوات نفسها التي اتبعتها في ربطك الأول.
- احذف المفاتيح التي لم تعد تستخدمها: اختر حذف وأكّد. إذا كان هناك بوت لا يزال يستخدم ذلك المفتاح، ترفض Freya الحذف وتخبرك بعددها، فأوقفها أو ألبثها أولاً.
أين تجد مفاتيح API الخاصة بك
انتقل إلى الإعدادات ← مفاتيح API. سترى مفاتيح API الخاصة بك، وهي قائمة بكل اتصالات المنصات على حسابك. ولكل واحد منها، تعرض Freya:
- المنصة (Binance أو OKX أو Bybit).
- تسمية للمفتاح، حتى تميّز بين عدة مفاتيح.
- تاريخ الإضافة.
- الحالة (نشط).
إذا لم تربط أي شيء بعد، فسترى بدلاً من ذلك موجّهاً لـ إضافة أول مفتاح API.
فهم صلاحيات المفتاح
يعرض كل مفتاح الصلاحيات التي أُنشئ بها، حتى لا يبقى أي شك حول ما يمكنه فعله:
- القراءة: تتيح لـ Freya رؤية أرصدتك ومراكزك (لازمة لكل شيء).
- التداول: تتيح لـ Freya فتح الأوامر وإدارتها (وهذا ما تستخدمه بوتاتك للتداول).
- Futures: تظهر عندما يكون للمفتاح صلاحية تداول العقود الآجلة مفعّلة أيضاً.
هذه الشفافية مهمة: مفتاح Freya مخصص لـ القراءة والتداول فقط. فهو لا يملك، ولا ينبغي أن يملك، صلاحية السحب، لذا لا يمكن أن تغادر أموالك منصتك عبر Freya أبداً. للصورة الكاملة، راجع هل أموالي آمنة على Freya Finance؟.
إضافة مفتاح آخر
يمكنك ربط أكثر من منصة (أو أكثر من مفتاح) من الشاشة نفسها عبر إضافة مفتاح API. الإعداد يتّبع الخطوات نفسها التي اتبعتها في ربطك الأول. راجع كيفية ربط منصتك للشرح خطوة بخطوة، بما في ذلك عبارة مرور OKX.
حذف مفتاح
لإزالة اتصال، اختر حذف على المفتاح وأكّد. إليك بضعة أمور ينبغي معرفتها:
- لا يمكن التراجع عنه. ستضطر إلى إضافة المفتاح من جديد لإعادة الربط.
- تتحقق Freya قبل الحذف. إذا كان أي بوت يعمل بذلك المفتاح، أو كان مسلَّحاً وينتظر التداول به، يُرفض الحذف وتُخبَر بعدد البوتات المعنية. أوقفها أو ألبثها من لوحة التحكم، ثم حاول مرة أخرى. فالبوت الذي يفقد مفتاحه أثناء الصفقة لم يعد قادراً على إدارة المركز الذي فتحه بالفعل.
- تصلك رسالة عند إزالة مفتاح، وهي لمسة أمنية تجعلك دائماً على علم عندما يتغيّر الوصول.
مفاتيحك مخزَّنة بأمان
تخزّن Freya بيانات اعتماد API الخاصة بك مشفَّرة، بل إن شاشة مفاتيح API تصفها بأنها مخزَّنة بأمان. وباجتماع ذلك مع مفاتيح لا تملك صلاحية السحب، فهذا يعني أنه حتى في أسوأ الحالات، لا يمكن لأحد نقل الأموال خارج حسابك على المنصة عبر Freya.
الأسئلة الشائعة
أين أدير مفاتيح API الخاصة بمنصتي؟
في الإعدادات ← مفاتيح API. تسرد تلك الشاشة كل مفتاح مرتبط مع منصته وتسميته وتاريخ إضافته وحالته، وهي المكان الذي تضيف فيه مفاتيح جديدة أو تحذف الموجودة.
ماذا تعني وسوم القراءة والتداول وFutures؟
تعرض ما يُسمح لكل مفتاح بفعله. القراءة تتيح لـ Freya رؤية أرصدتك ومراكزك؛ والتداول يتيح لها فتح الأوامر وإدارتها (وهو ما تستخدمه بوتاتك)؛ وتظهر Futures عندما يكون للمفتاح صلاحية تداول العقود الآجلة أيضاً. مفتاح Freya لا يحتاج أبداً إلى صلاحية السحب.
كيف أضيف منصة أو مفتاحاً آخر؟
استخدم إضافة مفتاح API على الشاشة نفسها. فهي تُجري خطوات الربط نفسها التي اتبعتها مع مفتاحك الأول. راجع دليل كيفية ربط منصتك للشرح الكامل، بما في ذلك عبارة مرور OKX الإضافية.
ماذا يحدث عندما أحذف مفتاح API؟
تتحقق Freya مما إذا كان هناك شيء لا يزال يعتمد عليه. إذا كان هناك بوت يعمل بذلك المفتاح، أو مسلَّحاً وينتظر إشارة، يُرفض الحذف وسترى عدد البوتات المعنية، فأوقفها أو ألبثها ثم احذف. وبمجرد ألا يعتمد أي شيء على المفتاح، تتم إزالة الاتصال ولا يمكن التراجع عنه. كما ستصلك رسالة تأكيد بأن المفتاح قد أُزيل.
هل مفاتيح API الخاصة بي مخزَّنة بأمان؟
نعم. تُخزَّن بيانات اعتمادك مشفَّرة، والمفاتيح التي تربطها لها صلاحية التداول فقط، وليست صلاحية السحب أبداً. هذا المزيج يعني أنه لا يمكن سحب أموالك من منصتك عبر Freya.
هل تستطيع Freya سحب أموالي باستخدام مفتاح API الخاص بي؟
لا. تُنشأ المفاتيح بصلاحية القراءة والتداول فقط، وليس السحب. وحتى لو حدث خطأ ما، لا يمكن لأحد نقل أموالك خارج المنصة باستخدام مفتاح Freya.
كيف أعدّل صلاحيات مفتاح API، أو أدوّره، أو أعطّله؟
لا يوجد «تعديل» مباشر لمفتاح مرتبط. لتغيير الصلاحيات أو تدوير مفتاح أو استبداله، تحذفه من Freya وتضيف المفتاح الجديد: أنشئ المفتاح المحدَّث على منصتك، ثم أعد ربطه. أوقف أو ألبث أولاً أي بوتات تستخدم المفتاح القديم، لأن Freya لن تزيل مفتاحاً لا يزال قيد الاستخدام. وبمجرد ربط المفتاح الجديد، وجّه تلك البوتات إليه وشغّلها من جديد. ولإيقاف استخدام مفتاح دون إزالته، ألبث البوتات التي تعتمد عليه بدلاً من حذف المفتاح.