الأسئلة الشائعة حول واجهة برمجة التطبيقات (API) على OKX
ما المقصود بعبارة المرور؟
هذه هي كلمة المرور التي أدخلتها عند التقدُّم بطلب لإنشاء مفتاح واجهة برمجة التطبيقات (API). ويتعيَّن عليك تذكُّرها بنفسك. وفي حال نسيانها، فلن تتمكَّن من استعادتها، وسيتعيَّن عليك إنشاء مفتاح API جديد.
كيف يمكنني إنشاء مفتاح API؟
باستخدام التطبيق:
1. سجِّل الدخول إلى حسابك لدى OKX > اختَر «القائمة» > مرِّر للأسفل واختَر «واجهة برمجة التطبيقات (API)» > «أنشِئ مفتاح API»
2. أدخِل اسم واجهة برمجة التطبيقات (API) > اختر «الحساب» و«الغرض» > أدخِل قائمة السماح (القائمة البيضاء) لعناوين IP > اختَر «الصلاحيات» > أدخِل «عبارة المرور»
باستخدام إصدار الويب
1. سجِّل الدخول إلى حسابك لدى OKX > انتقِل إلى «الملف الشخصي» واختر «واجهة برمجة التطبيقات (API) والاتصالات» > «أنشِئ مفتاح API»
2. أدخِل اسم مفتاح واجهة برمجة التطبيقات (API key) > اختر «الحساب» و«الغرض من الاستخدام»
3. أدخِل قائمة السماح (القائمة البيضاء) لعناوين IP > اختر «الصلاحيات» > أدخِل «عبارة المرور»
ملاحظة:
يُساعد تحديد عناوين IP على تأمين مفتاح API الخاص بك. علمًا أنَّه يمكنك ربط ما يصل إلى 20 عنوانًا لكل مفتاح، مع الفصل بينها باستخدام علامة الفاصلة أو مسافة عند إدخالها.
فكلمة المرور ضرورية لعرض معلومات واجهة برمجة التطبيقات (API) والوصول إلى واجهاتها. لذا يُرجى الاحتفاظ بكلمة المرور الخاصة بك بأمان. ويمكنك إنشاء واجهة برمجة تطبيقات (API) جديدة في حال فقدت كلمة المرور، إذ لا يمكننا استعادة واجهات برمجة التطبيقات (API).
كيف يمكنني إنشاء مفتاح API للتداوُل التجريبي؟
للتداوُل عبر واجهة برمجة التطبيقات (API) الخاصَّة بالتداوُل التجريبي، يتعيَّن عليك إنشاء مفتاح API ضمن بيئة التداوُل التجريبي. اتَّبع الخطوات التالية:
سجِّل الدخول إلى حسابك لدى OKX > «تداوُل» > «التداوُل التجريبي» > «المركز الشخصي» > «أنشِئ مفتاح API للحساب التجريبي» > ابدَأ التداوُل التجريبي
هل تنتهي صلاحية مفتاح API؟
ستُحذَف مفاتيح API غير المرتبطة بأي عنوان IP والتي تتمتَّع بصلاحيات التداوُل أو السحب تلقائيًا بعد 14 يومًا من عدم النشاط. علمًا أنَّ مفتاح API لا يُصنَّف على أنَّه غير نشِط إذا استُخدم لاستدعاء واجهات خاصَّة أو واجهات مرتبطة بالحساب تتطلَّب التحقُّق من الهوية، مثل عرض رصيد الحساب أو بيانات الفوترة أو تنفيذ الطلبات.
في حين لن تنتهي صلاحية مفاتيح API ذات صلاحية القراءة فقط والمرتبطة بعنوان IP أو بصلاحيات مُحدَّدة.
هل يمكن وضع الطلبات بوحدات العملة عند وضع الطلبات من خلال الواجهة؟
لا؛ بالنسبة لطلبات العقود، تُضبط الواجهة افتراضيًا على عدد العقود. إذا كنت بحاجة إلى حساب التحويل بين عدد العقود والعملات الرقمية، فيمكنك الرجوع إلى واجهة تحويل عدد العقود إلى العملات الرقمية هنا.
كيفية الحصول على معدل تقلب الواجهة؟
لا يمكن للواجهة الحصول مباشرة على ارتفاع السعر أو انخفاضه، ولكن يمكن حسابه من خلال معادلة حسابية.
قيمة الارتفاع والانخفاض لأحدث سعر معاملة مقارنةً بسعر افتتاح خط K قبل 24 ساعة ÷ 100% من سعر افتتاح خط K قبل 24 ساعة.
يمكن الحصول على بيانات الصيغة المذكورة أعلاه من خلال واجهة السوق من هنا.
ما هو سبب ظهور رسالة الخطأ "51000 Parameter posSide error" عند تقديم الطلب؟
يجب عليك أولًا التحقق من وضع الحساب؛ يمكنك عرض وضع الشراء/البيع أو وضع الفتح/الإغلاق هنا للحصول على معلمة posMode.
ملاحظة:
في حالة فتح وإغلاق الصفقات وتقديم الطلبات باستخدام العقد، تكون معلمة posSide مطلوبة، ويتم تنفيذ الصفقات الطويلة أو القصيرة.
في حال تفعيل وضع الشراء والبيع، أو إذا أُجريت معاملة عملة رقمية أو معاملة رافعة مالية في وضع الفتح والإغلاق، فإن معلمة posSide تدعم فقط صافي التحويل أو عدم التحويل.
ما هي الواجهة التي يمكن استخدامها للحصول على القيمة الاسمية للعقد والحد الأدنى لكمية الطلب؟
يمكنك استخدام الواجهة للحصول على المعلومات الأساسية لمنتجات التداول هنا.
القيمة الاسمية للعقد: ctVal، والحد الأدنى لكمية الطلب: minSz.
ما هو تنسيق instId؟
يمكنك استخدام الواجهة مباشرة للحصول على المعلومات الأساسية لمنتجات التداول هنا.
كيفية ضبط طلب وقف الخسارة وطلب جني الأرباح؟
إذا كان الطلب مرفقًا لجني الأرباح ووقف الخسارة، فيمكنك الرجوع إلى واجهة الطلب هنا: معلمات مُجموعة AlgoOrds.
ومع ذلك، إذا كان الطلب منفصلًا لوقف الخسارة، يمكنك الرجوع إلى واجهة عمولة الاستراتيجية هنا.
لماذا تم الإبلاغ عن خطأ عند تعيين سعر التفعيل لطلب جني الأرباح ووقف الخسارة: 51046، و51047، و51048، و51049؟
قواعد تعيين سعر تفعيل وقف الخسارة/سعر تفعيل جني الأرباح – أثناء البيع، يكون سعر تفعيل جني الأرباح أكبر من أحدث سعر للمعاملة، وسعر تفعيل وقف الخسارة أقل من أحدث سعر للمعاملة؛ في حين أثناء الشراء، يكون سعر تفعيل جني الأرباح أقل من أحدث سعر للمعاملة، وسعر تفعيل وقف الخسارة أكبر من أحدث سعر للمعاملة.
ما هو "خطأ الواجهة: 50102 انتهت صلاحية طلب الطابع الزمني"؟
يحدث هذا الخطأ عندما تنتهي صلاحية الطابع الزمني. يجب عليك استدعاء واجهة وقت النظام هنا لمزامنة وقتك المحلي مع وقت الخادم لدينا. يُساعد الحفاظ على فارق التوقيت ضمن 30 ثانية على تجنب هذه المشكلة.
ملاحظة: الوقت في رأس الطلب هو بالتوقيت العالمي المنسق 0. عند استدعاء واجهة وقت الخادم، يتم توفير الوقت بالتوقيت العالمي المنسق + 8.
ما هو "خطأ الواجهة: 50101 APIKey لا يتطابق مع البيئة الحالية"؟
يحدث هذا بسبب عدم التطابق بين مفتاح API وبيئة التداوُل الحالية (حقيقية أو تجريبية). إذ تتطلَّب طلبات استدعاء واجهة برمجة التطبيقات (أي الطلبات البرمجية التي يرسلها تطبيق أو برنامج إلى واجهة API لتنفيذ عمليات مثل الاستعلام عن البيانات أو تنفيذ الطلبات) ضمن الحساب الحقيقي استخدام مفتاح API المُخصَّص للحساب الحقيقي، ويجب أن تكون قيمة المُعامِل x-simulated-trading (مُعامِل يُحدِّد ما إذا كان الطلب موجَّهًا إلى بيئة التداوُل الحقيقي أو بيئة التداوُل التجريبي) في ترويسة الطلب (أي القسم العلوي من طلب الاتصال عبر بروتوكول HTTP الذي يحتوي على معلومات تعريفيَّة وإعدادات الطلب) مساوية للصفر (0). أمَّا طلبات الاستدعاء الخاصَّة بالحساب التجريبي فتتطلَّب استخدام مفتاح API مُخصَّص للحساب التجريبي، ويجب أن تكون قيمة المُعامِل x-simulated-trading في ترويسة الطلب مساوية للواحد (1).
ما هو "خطأ الواجهة: 51010 الطلب غير مدعوم في وضع الحساب الحالي"؟
هذا يتعلق بوضع حسابك. إذا كنت تريد وضع رافعة مالية أو عقد من عملة واحدة، فأنت بحاجة إلى التكيف مع الأوضاع الثلاثة الأخرى باستثناء وضع التداول الفوري! يمكنك ضبطه من خلال إعدادات الواجهة هنا، أو يمكنك ضبطه على الويب أو التطبيق.
ملاحظة: يجب تعيين الإعداد الأول على الصفحة أو التطبيق؛ خيار الإعدادات في القائمة الرئيسية لصفحة التداول - وضع الحساب.
ما هو "خطأ الواجهة: 51121 يجب أن تكون كمية الطلب مضاعفًا لحجم الدفعة"؟
في واجهة برمجة التطبيقات (API)، تكون طلبات العقود في وحدات من الشرائح ويجب أن تكون مضاعفًا للحد الأدنى لكمية الطلب لزوج العملة. يمكن الحصول على الحد الأدنى لكمية الطلب من خلال حقل minSz في واجهة المنتج هنا.
"خطأ السحب: 58207 عنوان السحب غير مدرج في القائمة البيضاء للإعفاء من التحقق"؛ لماذا لا يزال التحقق من القائمة البيضاء يُبلغ عن خطأ عند إغلاقه في صفحة السحب؟
لسحب العملات باستخدام واجهة API، يجب إضافة عنوان السحب على الصفحة وتفعيل خيار "غير مُتحقق به من visa". لن يؤثر إيقاف التحقق من القائمة البيضاء على وظيفة الواجهة على الصفحة.
ما هو "خطأ في الواجهة: 50004 انتهت مهلة طلب نقطة نهاية واجهة برمجة التطبيقات" (لا يعني أن الطلب كان ناجحًا أو فاشلًا، يرجى التحقق من نتيجة الطلب)؟
عادةً ما يكون سبب الخطأ 50004 هو الضغط الزائد على الخادم. الساعة 8 صباحًا، 16 صباحًا، و24 صباحًا هي أوقات تحصيل رسوم رأس المال يوميًا. في هذا الوقت، يكون ضغط الخادم مرتفعًا. من المستحسن إجراء المعاملات في هذه الأوقات. في حال ظهور الخطأ 50004 في أوقات أخرى، يُمكن إعادة المحاولة لاحقًا. إذا تم تقديم طلب به خطأ 50004، فهذا لا يُمثل النتيجة الفعلية لطلب الواجهة. قد ينجح الطلب أو يفشل. يرجى الرجوع إلى النتيجة الفعلية.
ملحوظة: إذا كانت لديك أي أسئلة أخرى أو استفسارات أخرى متعلقة بواجهة برمجة التطبيقات (API)، فيمكنك التواصل معنا عن طريق مسح الرمز أدناه عبر التطبيق.
ما هو الخطأ "50119 مفتاح واجهة برمجة التطبيقات غير موجود"؟
يحدث هذا الخطأ عادةً عندما لا يتطابق نطاق حسابك مع منطقتك.
بالنسبة إلى مستخدمي المنطقة الاقتصادية الأوروبية، يُرجى تغيير اسم نطاق طلب واجهة برمجة التطبيقات الخاص بك إلى eea.okx.com بدلًا من www.okx.com.
بالنسبة إلى مستخدمي الولايات المتحدة، يُرجى تغيير اسم نطاق طلب واجهة برمجة التطبيقات الخاص بك إلى us.okx.com بدلًا من www.okx.com.
إذا كنت تستخدم برنامجًا تابعًا لطرف ثالث للاتصال بـ OKX ورأيت هذا الخطأ، فيرجى التحقق مع موفر البرنامج لمعرفة ما إذا كان يدعم المجالات الإقليمية. على سبيل المثال، يجب على مستخدمي المنطقة الاقتصادية الأوروبية الاتصال عبر eea.okx.com، وإلا قد يفشل الطلب.
لماذا يظهر الخطأ "50110" عند الارتباط ببرنامج تابع لطرف ثالث؟
قد يحدث هذا الخطأ إذا كان نوع مفتاح API الحالي غير متوافق مع ربط برامج الطرف الثالث. حاول التقدم بطلب للحصول على نوع معاملة مفتاح API، دون ربط قائمة IP، ثم إعادة توصيل برنامج الطرف الثالث.
كيف يمكنني الحصول على أحدث سعر تداول لزوج عملات معيّن؟
استخدم التفاصيل من هنا الخاصة بواجهات الرموز، ولواجهة الرمز الفردية استخدم الرابط من هنا. تُستخدم واجهة الرموز للحصول على أحدث أسعار التداول لأزواج العملات بشكل دفعات، بينما يُستخدم الرمز للحصول على أحدث سعر تداول لزوج عملات واحد فقط.
مثال على معلمة الاستجابة الخاصة بآخر سعر تم تداوله في قسم "الرموز"