الموضوعات الشائعة

كيفية إنشاء مفتاح API على WEEX: صلاحية القراءة فقط أم التداول

By: WEEX
|
0

كيفية إنشاء مفتاح API على WEEX: صلاحية القراءة فقط أم التداول

سجّل الدخول إلى WEEX عبر الويب وانتقل إلى الحساب → إدارة API لإنشاء مفتاح API. تكون المفاتيح الجديدة مضبوطة افتراضيًا على القراءة فقط. إذا كان التطبيق يحتاج إلى التداول، فحدد إذن التداول الفوري أو العقود الآجلة/العقود المناسب.

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

ما الإذن الذي ينبغي أن أختاره؟

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

لا يمكن لمفتاح القراءة فقط تقديم الأوامر أو إلغاؤها. تحقّق من أذونات التداول الفوري وتداول العقود كلٌّ على حدة؛ فتفعيل أحدهما لا يعني أن الآخر متاح. يشرح دليل التحضير للتداول الفوري ودليل التحضير للعقود الآجلة صلاحيات الوصول ذات الصلة.

إنشاء مفتاح API

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

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

كيف تُستخدم APIKey وSecretKey وPassphrase؟

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

إذا طلبت أداة ما «كلمة مرور API»، فتحقّق من تعريف الحقل. فعلى سبيل المثال، يأخذ الحقل password في CCXT عبارة مرور WEEX API. وقد تؤدي قيمة غير صحيحة إلى تعذّر مصادقة طلب خاص حتى عندما يكون APIKey وSecretKey صحيحين.

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

اربط عنوان IP الذي يستخدمه تطبيقك فعليًا

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

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

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

لماذا قد لا يعمل المفتاح بعد إنشائه؟

ابدأ من موضع حدوث الخلل بدلًا من إنشاء مفاتيح بديلة مرارًا:

العَرَضما ينبغي التحقق منه أولًا
تنجح استعلامات الحساب، لكن الأوامر تفشلإذن التداول للسوق المستهدف. ومن الأسباب المحتملة لظهور -1052 عدم تطابق الأذونات.
تفشل مصادقة الطلبات الخاصةعبارة مرور API والتوقيع والطابع الزمني وعنوان IP الصادر الفعلي.
يتعذر استخدام مفتاح أُنشئ أو عُدّل حديثًا مؤقتًاتذكر الأسئلة الشائعة الحالية أن وقت الانتشار المعتاد يبلغ نحو 15 دقيقة، وليس موعدًا نهائيًا مضمونًا.
استمرار ظهور «تقييد API»تواصل مع الدعم الرسمي بشأن قيود الحساب بدلًا من إرسال طلبات غير صالحة مرارًا.

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

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

المقالات ذات الصلة
مشاركة
copy

الرابحون

iconiconiconiconiconiconiconiconicon
دعم العملاء:@weikecs
التعاون التجاري:@weikecs
التداول الكمي وصناع السوق:bd@weex.com
برنامج VIP:support@weex.com