الأسئلة الشائعة
س1: عدم القدرة على الانسحاب من الأموال حتى بعد إضافة العنوان إلى القائمة البيضاء
الأسباب:
1. القائمة البيضاء على صفحة الانسحاب والقائمة البيضاء للانسحاب عبر واجهة برمجة التطبيق مستقلتان عن بعضهما البعض.
2. العناوين المضافة عبر [صفحة الانسحاب] > [إدارة عناوين الانسحاب] لا تنطبق على عمليات الانسحاب عبر واجهة برمجة التطبيق.
الحل:
قم بزيارة صفحة إدارة القائمة البيضاء للانسحاب عبر واجهة برمجة التطبيق: https://www.coinex.com/apikey
أضف عنوان الانسحاب إلى القائمة البيضاء الخاصة بواجهة برمجة التطبيق.
س2: خطأ access_id not exist
الأسباب الشائعة:
(1) عادة ما تستغرق مفاتيح واجهة برمجة التطبيق المنشأة حديثًا حوالي 10 دقائق لتصبح نشطة. قد يؤدي استدعاء واجهة برمجة التطبيق مباشرة بعد الإنشاء إلى ظهور هذا الخطأ.
(2) معرف الوصول (access_id) غير صحيح.
(3) فشل التحقق من التوقيع.
(4) رأس الطلب غير صحيح.
الحل:
(1) راجع [وثائق واجهة برمجة التطبيق CoinEx] لمعرفة كيفية إنشاء طلب مصادقة HTTP.
(2) مثال توضيحي:
س3: خطأ 3008/4001 service unavailable
السبب: قد يحدث هذا الخطأ عند إلغاء الطلبات خلال فترات الحمل العالي على الخادم.
الحل:
(1) إعطاء الأولوية لإلغاء الطلبات المهمة.
(2) إعادة المحاولة بعد 1-2 ثانية.
(3) إذا عادت الاستجابة برمز: 0 ولكن لم يتم إلغاء الطلب:
سجل الطلب والاستجابة الكاملة.
اتصل بدعم العملاء وقدم معلومات الحساب الرئيسي/الفرعي للحصول على المساعدة.
س4: خطأ في المعلمة
السبب: يحدث هذا عادة عندما لا تتطابق المعلمات المرفوعة مع الأنواع المحددة في وثائق واجهة برمجة التطبيق.
الحل: باستخدام نقطة النهاية POST /spot/cancel-order كمثال:
(1) قارن بدقة أسماء المعلمات وأنواعها في وثائق واجهة برمجة التطبيق.
(2) انتبه بشكل خاص إلى الاختلافات بين الأنواع الرقمية وأنواع السلاسل النصية.
س5: ما هي حدود معدل واجهة برمجة التطبيق؟
تنقسم حدود المعدل إلى حدود معدل قصيرة المدى وحدود معدل طويلة المدى، والتي يمكن تحديدها عبر رأس الاستجابة:
1. حدود المعدل قصيرة المدى: إذا كانت قيمة X-RateLimit-Limit أكبر من 0، فلم يتم تفعيل حد المعدل قصير المدى.
يستخدم الحد قصير المدى آلية دلو الرموز، مع حدود معدل مستقلة للحسابات الرئيسية والفرعية.
الخطأ الشائع بعد التفعيل: الرمز: 213، 4213
الرسالة: الرجاء عدم المحاولة بشكل متكرر.
2. حدود المعدل طويلة المدى: إذا تم إرجاع X-RateLimit-LongPeriod-{period}-Remaining، فقد تم تفعيل حدود المعدل طويلة المدى. يقوم النظام بتقييم حجم وجودة طلبات المستخدم لتحديد ما إذا كان سيفرض حدودًا على إجمالي الطلبات على مدى فترة أطول. بعد التفعيل، سيتم تحديد معدلات الطلب لجميع نقاط النهاية (باستثناء إلغاء الطلب) إلى طلب واحد في الثانية.
الخطأ الشائع: الرمز: 213، 4213
يلزم حكم إضافي عبر رأس الاستجابة.
أسئلة شائعة أخرى
س1: كيفية تقليل زمن استجابة طلبات واجهة برمجة التطبيق؟
تم نشر الخوادم على AWS طوكيو وتدعم موازنة الحمل عبر المناطق. يمكنك اختيار منطقة قريبة لتقليل زمن الاستجابة.
المناطق المتاحة:
ap-northeast-1a
ap-northeast-1c
ap-northeast-1d
س2: هل المصادقة الثنائية مطلوبة لعمليات الانسحاب عبر واجهة برمجة التطبيق؟
لأسباب أمنية:
1. قبل استخدام عمليات الانسحاب عبر واجهة برمجة التطبيق، يجب عليك تسجيل الدخول والتفويض عبر المصادقة الثنائية.
2. بعد إضافة عناوين الانسحاب إلى [القائمة البيضاء للانسحاب]، يمكنك بدء عمليات الانسحاب عبر واجهة برمجة التطبيق دون الحاجة إلى مزيد من التحقق عبر المصادقة الثنائية.
س3: هل يمكن إضافة عناوين القائمة البيضاء للانسحاب عبر واجهة برمجة التطبيق؟
حاليًا، لا يتم دعم إضافة عناوين القائمة البيضاء للانسحاب عبر واجهة برمجة التطبيق. يرجى الانتقال إلى [إدارة API] > [الانسحاب من القائمة البيضاء] لإضافة العناوين يدويًا أو دفعة واحدة.
س4: خطأ التوقيع غير صحيح
الحلول:
1. تحقق مما إذا كان تم تكوين access_id و secret_key بشكل صحيح.
2. تحقق مما إذا كان نص الطلب والمعلمات المستخدمة لإنشاء التوقيع متطابقة. قم بمعالجة معلمات الطلب كسلاسل نصية وتأكد من التناسق قبل وبعد التوقيع.
3. إذا تم استخدام مكتبة طرف ثالث للتوقيع، تأكد من تكوينها بشكل صحيح.
س5: خطأ فحص Tonce - يجب أن يكون Tonce الصحيح في غضون دقيقة واحدة من الوقت الحالي
الحل:
(1) تأكد من أن الطابع الزمني لجميع طلبات واجهة برمجة التطبيق بالميلي ثانية.
مثال:
(2) تحقق من أن جهاز الكمبيوتر الخاص بك قد مكّن مزامنة الوقت التلقائية.
س6: كيفية استرداد الرصيد المتاح الفعلي والقيمة الصافية لحساب العقود الآجلة؟
(1) استخدم نقطة النهاية /assets/futures/balance لاسترداد الحقل المتاح، الذي يشير إلى الرصيد المتاح الحالي لحساب العقود الآجلة.
(2) لا تدعم نقاط نهاية واجهة برمجة التطبيق حاليًا إرجاع القيمة الصافية للحساب. القيمة الصافية هي مجموع الأرباح والخسائر المحققة وغير المحققة.
(3) الأرباح والخسائر غير المحققة ليست قيمًا ثابتة وقد تتقلب مع تغيرات المركز. مطلوب حسابات يدوية للحصول على نتائج دقيقة.
(4) للحصول على صيغ الحساب، راجع وثائق "كيفية حساب حقوق الملكية في الحساب والربح والخسارة للعقد الآجل".
س7: كيفية معالجة البيانات التي تعيدها واجهة برمجة تطبيق WebSocket؟
تعيد واجهة برمجة تطبيق WebSocket البيانات بتنسيق سلسلة JSON مضغوطة، والتي يجب فك ضغطها قبل الاستخدام (على سبيل المثال، باستخدام وحدة gzip).
الخطأ الشائع:
utf-8 codec can't decode byte 0x8b in position 1: invalid start byte
س8: ماذا تفعل إذا أبلغت منصة ضرائب تابعة لجهة خارجية عن خطأ؟
تم إيقاف خدمات V1 في 25 سبتمبر 2024. قد يكون الخطأ بسبب عدم ترقية المنصة لرمزها إلى V2. يرجى الاتصال بمنصة الضرائب ذات الصلة للحصول على المساعدة.
س9: كيفية تأكيد نجاح اتصال WebSocket؟
عند الاشتراك بنجاح، سيتم استلام استجابة نتيجة الاشتراك.
بعد ذلك، ستتلقى تحديثات الرسائل المشترك بها:
س10: لماذا ينقطع اتصال WebSocket تلقائيًا؟ كيفية الحفاظ على الاتصال؟
(1) عادة ما تكون انقطاعات WebSocket ناتجة عن مشاكل في الشبكة. يرجى التحقق مما إذا كان اتصال الشبكة مستقرًا.
(2) للحفاظ على اتصال WebSocket، تحتاج إلى استخدام server.ping للحفاظ على نشاطه.
(3) إذا لم يكن هناك اتصال مع الخادم لمدة دقيقة واحدة، سيتم قطع اتصال WebSocket تلقائيًا. يُنصح بتعيين فاصل زمني للإرسال في غضون 60 ثانية عبر واجهة ping للحفاظ على الاتصال نشطًا.
بالنسبة لأخطاء واجهة برمجة التطبيق الأخرى، يرجى النقر هنا للاتصال بدعم العملاء وتقديم المعلومات التالية للمساعدة في حل المشكلة:
(1) البريد الإلكتروني للحساب الرئيسي أو اسم المستخدم للحساب الفرعي.
(2) تفاصيل كاملة عن الطلب والاستجابة.
هام: لا تشارك access_id و secret_key في رسائل الخطأ لتجنب الخسائر غير الضرورية.