Exchange
بورصة الأصول الرقمية و البلوكشين
Academy
تعليم البلوكشين و العملات الرقمية
وسيط
حلول التداول النهائية
Charity
الجمعيات الخيرية
Cloud
حلول مشروع البورصة
DEX
بورصة أصول رقمية لامركزية سريعة وآمنة
Labs
حاضنة لأعلى مشاريع البلوكشين
Launchpad
منصّة إطلاق الرموز المميزة
Research
تحاليل و تقارير على مستوى أكاديمي
Trust Wallet
محفظة Binance الرسمية للعملات الرقمية
شراء العملات الرقمية
الأسواق
تحويل
أسهل طريقة للتداول
كلاسيكي
واجهة بسيطة وسهلة الإستخدام
متقدم
الوصول الكامل إلى جميع أدوات التداول
التداول الاقتراضي
زِد من أرباحك باستخدام الرافعة المالية
شخص لشخص
التحويل المصرفي وأكثر من 100 خيارًا
رموز الأسهم
New
تداول الأسهم بالعملة الرقمية
تداول
NFT
امسح لتحميل تطبيق IOS و Android
تحميل
English
USD
مركز الدعم
الأسئلة الشائعة
API
قواعد التداول عبر API
الأسئلة الأكثر شيوعاً عن واجهة برمجة التطبيق
Binance
2021-05-10 01:27

وثيقة واجهة برمجة التطبيق | أمثلة على واجهات برمجة التطبيق غير الرسمية 

ما الحدود؟

نظرة عامة
هناك ثلاثة أنواع مختلفة من الحدود، وكلها عرضة للتغيير في أي وقت، وهي:
  1. الحدود القصوى
  2. حدود تعلم الآلة (ML)
  3. حدود جدار حماية تطبيق الويب (WAF)
الحدود القصوى:
  • 1200 وزن طلبات في الدقيقة (يرجى العلم أن هذا لا يساوي بالضرورة 1200 طلب)
  • 50 طلب في كل 10 ثوانٍ
  • 160,000 طلب في كل 24 ساعة
الحدود القصوى التي نفرضها مذكورة في نقطة نهاية [/api/v3/exchangeInfo].
حدود تعلم الآلة (ML):
يتم تقييم سلوك التداول على أساس المستخدم العادي، وإذا انحرفت بعيداً عن هذا الأساس كثيراً، سيتم حظرك لمدة محددة من الوقت تتراوح بين 5 دقائق و3 أيام.
لنفترض أن لديك تصنيف لإساءة استخدام التداول، ستزداد درجة هذا التصنيف إذا: 
  • قمت بصورة متكررة بـ "الاستباق" أو "تسجيل سعر أعلى" من أفضل عرض/طلب في قائمة الطلب.
  • أكثرت من إنشاء الطلبات وإلغائها سريعاً جداً بشكل عشوائي دون تنفيذ الصفقات.
  • كان "معدل التحويل" الخاص بك منخفضاً. "معدل التحويل" هو عدد عمليات التداول التي قمت بها مقسومة على إجمالي عدد مرات إنشاء الطلبات وإلغائها خلال فترة 24 ساعة [عدد الصفقات ÷ (عدد الطلبات + عدد مرات الإلغاء)].
  • كان "وزن التداول" الخاص بك منخفضاً. "وزن التداول" هو إجمالي الكمية المتداولة مقسومة على إجمالي عدد مرات إنشاء الطلبات وإلغائها خلال فترة 24 ساعة [إجمالي الكمية المتداولة ÷ (عدد الطلبات + عدد مرات الإلغاء)].
  • ستكون درجة تصنيف إساءة الاستخدام الخاصة بك أكبر كثيراً في حالة تداول الأزواج التي تكون عملة الأساس أو أصل التسعير بها هو عملة BNB.
لن يتم تقديم أي معلومات أكثر تحديداً مما سبق. ويرجى استخدام التجربة والخطأ للتوصل إلى نمط التداول المثالي لك، أو مناقشة السلوك الأمثل مع مستخدمي واجهة برمجة التطبيق الآخرين.
حدود جدار حماية تطبيق الويب:
في حين أننا لا نقدم بيانات دقيقة عن قواعدنا فيما يخص حدود جدار حماية تطبيق الويب، إلا أنك ستكون قد خرقت إحدى قواعدنا إذا كان يظهر لك خطأ HTTP 403، وسيكون هذا على الأرجح نتيجة الطلبات الزائدة عن الحد خلال مدة 5 دقائق. ولكن إذا كنت ترسل طلباً قد يُنظر إليه على أنه خبيث، فقد يتسبب ذلك في حظرك لمدة أطول.

إذا تجاوزت الحدود، هل سيتم تقييد استخدامي من خلال الحساب أم مفتاح واجهة برمجة التطبيق أم عنوان IP؟

فيما يخص الحدود القصوى، فإن تجاوز حد إجمالي وزن الطلبات في الدقيقة (وهو حالياً 1200) سيؤدي إلى حظر عنوان IP. ستعتمد حدود الطلبات (وهي حالياً 50 مرة كل 10 ثوانٍ و160000 مرة كل 24 ساعة) على الحساب. إذا تجاوز المستخدم حد الطلبات، سيُمنَع من إنشاء طلبات جديدة من خلال الموقع الإلكتروني (أو تطبيقاتنا الأخرى).
أما فيما يخص حدود تعلم الآلة، فسيتم تطبيق القيود على الحساب. إذا تعرض أحد المستخدمين للحظر بواسطة نظام تعلم الآلة، يمكنه التحقق من السبب والمدة باستخدام نقطة نهاية [/sapi/v1/account/status] (المذكورة في وثيقة واجهة برمجة التطبيق الخاصة بنا).
لن يتم تطبيق حدود جدار حماية تطبيق الويب سوى على عنوان IP. تكون مدة حظر جدار حماية تطبيق الويب عادةً 5 دقائق، ولكن إذا فسَّر الخادم طلب المستخدم بأنه خبيث، يمكن مد فترة الحظر.

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

كلا، عليك الانتظار حتى انتهاء الحظر.

أتلقى رسالة خطأ HTTP 403 عندما أستخدم واجهة برمجة التطبيق، لماذا؟

لقد انتهكت قواعد جدار حماية تطبيق الويب (WAF)، على الأرجح باختراق حد المعدل المسموح به أو إرسال طلب خبيث (كما هو موضح في القسم الخاص بالحدود في هذه الوثيقة). تستمر هذه الأنواع من الحظر عادةً 5 دقائق.

لماذا تم تعطيل/إيقاف اتصالات WebSocket الخاصة بي؟

سيتم اختبار اتصالات WebSocket النشطة كل 3 دقائق، وإذا لم تستجِب لذلك الاختبار في إطار مناسب، سيتم إنهاء اتصالك.
فيما يخص تدفقات بيانات المستخدم، إذا لم يتم تلقي رسالة الحفاظ على الاتصال مرة على الأقل كل 60 دقيقة، فستنتهي صلاحية مفتاح الاستماع. وهذا موضح بالتفصيل أيضاً في وثيقة واجهة برمجة التطبيق الخاصة بنا.

أستخدم خدمة/غلاف برمجي مقدم من طرفٍ خارجي، وهو لا يعمل، هل يمكنكم مساعدتي؟

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

أتلقى رسائل خطأ فجأة رغم عدم قيامي بأي تغييرات. ماذا حدث؟

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

أحتاج إلى الوصول إلى مفتاحي السري ولكنه يظهر كما يلي "***". كيف أستعيده؟ 

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

هل يمكنني زيادة الحدود أو التدفق/النطاق الترددي المخصص؟

للأسف، لا نقدم هذه الخدمة حالياً. ويفترض أن تكون الحدود التي قدمناها مناسبة. 

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

ليس هناك سوى تفسيران محتملان لـ"اختفاء" مفتاح واجهة برمجة التطبيق، وهما:
  1. إذا لم تكُن نشطاً مؤخراً وكنت تستخدم واجهة برمجة التطبيق قبل 7 مارس 2018، من المحتمل أن يكون قد تمت إزالة مفتاح (مفاتيح) واجهة برمجة التطبيق الخاص بك للتأكد من سلامة حسابك.
  2. وإلا فلا بد أنك اخترت تعطيل حسابك، وهذا سيؤدي إلى حذف أي مفاتيح واجهة برمجة تطبيق نشطة.
من المفترض أن تتمكن من إنشاء مفتاح (مفاتيح) واجهة برمجة تطبيق جديد دون أي مشاكل.

أتلقى الرسالة التالية: "خطأ -1021 (رسالة: الطابع الزمني لهذا الطلب خارج نطاق recvWindow)". كيف أحل هذه المشكلة؟

لا يحدث هذا الخطأ عادةً إلا في حالة عدم التزامن بين توقيت الخادم وتوقيت نظامك، ربما تضطر إلى مزامنة الساعة في نظامك، ولكن هذه العملية تختلف باختلاف نظام التشغيل.
ففي نظام Windows، يمكنك استخدام أداة مثل "Atomic Clock" حسبما ترى. أما مستخدمي أنظمة Linux وMac فيمكنهما محاولة المزامنة باستخدام "ntpdate" من خلال سطر الأوامر.
إذا لم تستطِع حل المشكلة، ربما تكون متعلقة بوقت التأخير (وهي مشكلة في الشبكة) وقد يكون عليك تعديل recvWindow الخاصة بك.

هل يمكنني طلب وظائف جديدة لواجهة برمجة التطبيق؟

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

أعتقد أن هناك مشكلة في واجهة برمجة التطبيق. كيف يمكنني الإبلاغ عنها؟

إذا شعرت بأن هناك مشكلة في النظام وليس في طريقة استخدامك، يرجى تقديم دليل يؤيد صحة ادعائك بالتواصل معنا من خلال دردشة واجهة برمجة التطبيق على Telegram، وسنحقق في الأمر. يرجى العلم بأننا لا نقبل الرسائل المبهمة ولا نعتبرها شكاوى حقيقية. وعلاوةً على ذلك، فهذه ليست مجموعة للدعم البرمجي الرسمي، وإنما مجموعة لمستخدمي واجهة برمجة تطبيق بينانس Binance API.