وثائق واجهة برمجة التطبيق丨واجهة برمجة التطبيق: المكتبات مفتوحة المصدر والأمثلة
ما الحدود؟
نظرة عامة
هناك ثلاثة أنواع مختلفة من الحدود، وكلها عرضة للتغيير في أي وقت، وهي:
- الحدود القصوى
- حدود تعلم الآلة (ML)
- حدود جدار حماية تطبيق الويب (WAF)
الحدود القصوى
- وزن الطلبات في الدقيقة يبلغ 6000 (يرجى العلم أن هذا لا يساوي بالضرورة 6000 طلب)
- 50 طلب في كل 10 ثوانٍ
- 160,000 طلب في كل 24 ساعة
الحدود القصوى التي نفرضها مذكورة في نقطة نهاية [/api/v3/exchangeInfo].
حدود تعلم الآلة
يتم تقييم سلوك التداول على أساس المستخدم العادي، وإذا انحرفت بعيدًا عن هذا الأساس، سيتم حظرك لمدة محددة من الوقت تتراوح بين 5 دقائق و3 أيام.
لنفترض أن لديك تصنيف لإساءة استخدام التداول، ستزداد درجة هذا التصنيف إذا:
- قمت بصورة متكررة بـ "الاستباق" أو "تسجيل سعر أعلى" من أفضل عرض/طلب في قائمة الطلب.
- أكثرت من إنشاء الطلبات وإلغائها بسرعة كبيرة بشكل عشوائي دون تنفيذ التداولات.
- كان "معدل التحويل" الخاص بك منخفضاً؛ و"معدل التحويل" هو عدد عمليات التداول التي قمت بها مقسومة على إجمالي عدد مرات إنشاء الطلبات وإلغائها خلال فترة 24 ساعة (عدد الصفقات / (عدد الطلبات + عدد مرات الإلغاء)).
- كان "وزن التداول" الخاص بك منخفضاً؛ و"وزن التداول" هو إجمالي الكمية المتداولة مقسومة على إجمالي عدد مرات إنشاء الطلبات وإلغائها خلال فترة 24 ساعة (إجمالي الكمية المتداولة / (عدد الطلبات + عدد مرات الإلغاء)).
- ستكون درجة تصنيف إساءة الاستخدام الخاصة بك أكبر كثيراً في حالة تداول الأزواج التي تكون عملة الأساس أو أصل التسعير بها هو عملة BNB.
لن يتم تقديم أي معلومات أكثر تحديداً مما سبق. ويرجى استخدام التجربة والخطأ للتوصل إلى نمط التداول المثالي لك، أو مناقشة السلوك الأمثل مع مستخدمي واجهة برمجة التطبيق الآخرين.
حدود جدار حماية تطبيق الويب:
في حين أننا لا نقدم تفاصيلاً دقيقة عن القواعد التي نطبقها فيما يتعلق بحدود جدار حماية تطبيق الويب، فسوف تظهر لك رسالة خطأ HTTP 403 إذا خالفت إحدى هذه القواعد. وسيكون هذا على الأرجح نتيجة الطلبات الزائدة عن الحد خلال مدة 5 دقائق. ولكن إذا كنت ترسل طلبًا يمكن اعتباره خبيثًا، فقد يتسبب ذلك في حظرك لمدة أطول.
إذا تجاوزت الحدود، هل سيتم تقييد استخدامي من خلال الحساب أم مفتاح واجهة برمجة التطبيق أم عنوان IP؟
فيما يخص الحدود القصوى، فإن تجاوز حد إجمالي وزن الطلبات في الدقيقة (وهو حاليًا 6000) سيؤدي إلى حظر عنوان IP. ستعتمد حدود الطلبات (وهي حاليًا 50 مرة كل 10 ثوانٍ و160,000 مرة كل 24 ساعة) على الحساب. إذا تجاوز المستخدم حد الطلبات، سيُمنَع من إنشاء طلبات جديدة على الموقع الإلكتروني (أو تطبيقاتنا الأخرى).
أما فيما يخص حدود تعلم الآلة، فسيتم تطبيق القيود على الحسابات. وإذا تعرضت للحظر بواسطة نظام تعلم الآلة، يمكنك التحقق من السبب والمدة باستخدام نقطة نهاية [/sapi/v1/account/status] (المذكورة في وثائق واجهة برمجة التطبيق الخاصة بنا).
لن يتم تطبيق حدود جدار حماية تطبيق الويب سوى على عنوان IP. تكون مدة حظر جدار حماية تطبيق الويب عادةً 5 دقائق، ولكن إذا فسَّر الخادم طلب المستخدم بأنه خبيث، يمكن مد فترة الحظر.
تم تقييد استخدامي لتجاوز الحدود، ولكني أصلحت التعليمات البرمجية، هل ستقومون بفك حظري مبكراً؟
كلا، عليك الانتظار حتى انتهاء الحظر.
لماذا تلقيت رسالة خطأ HTTP 403 عند استخدام واجهة برمجة التطبيق؟
لقد انتهكت قواعد جدار حماية تطبيق الويب (WAF)، على الأرجح باختراق حد المعدل المسموح به أو إرسال طلب خبيث (كما هو موضح في القسم الخاص بالحدود في هذه الوثيقة). تستمر هذه الأنواع من الحظر عادةً 5 دقائق.
لماذا تم تعطيل/إيقاف اتصالات WebSocket الخاصة بي؟
سيتم اختبار اتصالات WebSocket النشطة كل 3 دقائق، وإذا لم تستجِب لذلك الاختبار في إطار مناسب، سيتم إنهاء اتصالك.
فيما يخص تدفقات بيانات المستخدم، في حالة عدم استلام رسالة الحفاظ على الاتصال مرة على الأقل كل 60 دقيقة، فستنتهي صلاحية مفتاح الاستماع. وهذا موضح بالتفصيل أيضًا في وثائق واجهة برمجة التطبيق.
أستخدم خدمة/غلاف برمجي مقدم من طرفٍ خارجي، وهو لا يعمل، هل يمكنكم مساعدتي؟
للأسف، لا ندعم الأدوات أو الخدمات المقدمة من أطراف خارجية. يرجى التواصل مع مقدم الخدمة والمطورين للحصول على المزيد من المساعدة.
إضافةً إلى ذلك، هناك خطورة في إدخال مفتاح (أو مفاتيح) واجهة برمجة تطبيق بينانس (Binance API) أو المفتاح السري الخاص بك في أي منصة خارجية. يرجى استخدام هذه الخدمات وفق ما تراه مناسباً.
يرجى العلم أننا نتجنب أيضاً تقديم مساعدة برمجية عامة.
أتلقى رسائل خطأ فجأة رغم عدم قيامي بأي تغييرات. ماذا حدث؟
للأسف، لا يمكننا تقديم الدعم للمشاكل الخاصة بطريقة استخدامك الشخصية. إذا كنت تستخدم أداة أو غلاف برمجي مقدم من طرفٍ خارجي، يرجى الاتصال بفريق الدعم أو التطوير الخاص به للحصول على المساعدة.
أحتاج إلى الوصول إلى مفتاحي السري ولكنه يظهر كما يلي "***". كيف أستعيده؟
لأسباب أمنية، تصميم المفاتيح السرية لا يسمح لها بالظهور سوى في وقت إنشاء مفتاح واجهة برمجة التطبيق فقط، ويتم إخفاؤها في أي وقت بعد هذه اللحظة. إذا فقدت المفتاح السري أو لم تسجله، سيكون عليك إنشاء مفتاح جديد لواجهة برمجة التطبيق واستخدامه بمفتاح سري جديد.
هل يمكنني زيادة الحدود أو التدفق/النطاق الترددي المخصص؟
للأسف، لا نقدم هذه الخدمة حالياً. ويفترض أن تكون الحدود التي قدمناها مناسبة.
اختفى مفتاح واجهة برمجة التطبيق الخاصة بي.
ليس هناك سوى تفسيران محتملان لـ"اختفاء" مفتاح واجهة برمجة التطبيق، وهما:
- إذا لم تكن نشطًا مؤخرًا وكنت تستخدم واجهة برمجة التطبيق قبل 7 مارس 2018، من المحتمل أن يكون قد تمت إزالة مفتاح واجهة برمجة التطبيق الخاص بك حفاظًا على سلامة حسابك.
- 2. إذا اخترت تعطيل حسابك، سيؤدي هذا إلى حذف جميع المفاتيح النشطة لواجهة برمجة التطبيق.
من المفترض أن تتمكن من إنشاء مفتاح (مفاتيح) واجهة برمجة تطبيق جديد دون أي مشاكل.
أتلقى الرسالة التالية: "خطأ -1021 (رسالة: الطابع الزمني لهذا الطلب خارج نطاق recvWindow)". كيف أحل هذه المشكلة؟
لا يحدث هذا الخطأ عادةً إلا في حالة عدم تزامن توقيت الخادم وتوقيت نظامك، وربما تضطر إلى مزامنة الساعة في نظامك، لكن هذه العملية تختلف باختلاف نظام التشغيل.
ففي نظام Windows، يمكنك استخدام أداة مثل "Atomic Clock" حسبما ترى. أما مستخدمي أنظمة Linux وMac فيمكنهما محاولة المزامنة باستخدام "ntpdate" من خلال سطر الأوامر.
إذا ظلت المشكلة قائمة، ربما تكون متعلقة بوقت التأخير (وهي مشكلة في الشبكة)، يُرجى تعديل recvWindow الخاص بك.
هل يمكنني طلب وظائف جديدة لواجهة برمجة التطبيق؟
إذا لم تجد الوظيفة التي تطلبها في وثيقتنا، فاعلم أننا لا نقدمها. إذا كنت تود اقتراح ميزة ما، يمكنك فتح تذكرة دعم وسيتم مراجعتها.
أعتقد أن هناك مشكلة في واجهة برمجة التطبيق. كيف يمكنني الإبلاغ عنها؟
إذا شعرت بأن هناك مشكلة في النظام وليس في طريقة استخدامك، يُرجى تقديم دليل لدعم ما تقول من خلال التواصل معنا في منتدى المطورين وسنحقق في الأمر. يُرجى العلم أننا لا نقبل الرسائل المبهمة ولا نعتبرها شكاوى حقيقية.
تم التحديث في 24 أكتوبر 2023