SDK استكشاف أخطاء التكامل

شخص مشاكل Trading Widgetو Agent SDK والتوقيع والويبهوك وانتهاء الوقت والبيئة قبل تصعيد طلب الدعم.

View as Markdown

ابدأ بالبيئة، والطابع الزمني، ومعرف الأعمال للعملية الفاشلة. عادة ما يفصل الفحص المنظم مشاكل التكوين عن مشاكل المصادقة، الشبكة، والمعالجة غير المتزامنة.

ترتيب التشخيص الموصى به

  1. تأكد من البيئة المتأثرة والقاعدة URL.
  2. تسجيل النطاق الزمني UTC وأول طلب فاشل.
  3. حدد الوحدة: Trading Widget، Agent SDK، REST API، WebSocket، أو webhook.
  4. التقاط معرف الطلب، معرف المستخدم الشريك، agentOrderNo، معرف الطلب، أو معرف حدث webhook.
  5. تحقق من الشيفرة الأخيرة، وبيانات الاعتماد، والقائمة البيضاء IP ، أو تغييرات النشر.
  6. التكاثر بأصغر حالة اختبار آمنة.

Trading Widget القضايا

عَرَضالسبب المحتملالإصلاح
طلبات iframe شريك النطاق المحليbaseUrl مفقودتمرير baseUrl: ‘https://app.6mm.com’.
iframe غير مرئي أو قصير جداالحاوية الأم لا تحتوي على ارتفاعحدد ارتفاع الحاوية أو ارتفاع التمرير.
token_provider_missingوضع الشريك-الرمز لا يحتوي على مزودأضف التوثيق.tokenProvider.
auth_exchange_failedرمز تضمين غير صالح، منتهية الصلاحية، أو غير متطابقتحقق من استجابة الرموز الخلفية و channelId.

Agent SDK القضايا

عَرَضالسبب المحتملالإصلاح
تم رفض التوقيعسر خاطئ، انحراف الساعة، أو تغيير الحقول الموقعة يدويادع SDK تولد حقول التوقيع وتزامن وقت الخادم.
مخاطر حركة الأموال المكررةرقم الطلب الجديد المستخدم بعد انتهاء المهلةاستعلام من agentOrderNo الأصلي أولا.
PROCESSING يعامل كفشلسوء فهم الولاية المنتظرانتظر webhook أو اتصل queryOrder.
تمت معالجة Webhook عدة مراتإعادة المحاولة بدون القدر الجنسيأضف مفتاح القدر والتحقق النهائي.

أدلة للقبض عليها

التكاملأدلة مفيدة
Trading WidgetURL الصفحة، مسار الإصدار SDK، وحدة تحكم المتصفح، طلبات الشبكة الفاشلة، حمولة onError، وأبعاد الحاويات.
Agent SDKSDK اللغة/الإصدار، URL الأساسية، UTC الطابع الزمني، معرف الطلب، agentOrderNo، رمز الرد، والسجلات المنقحة.
ويب هوكوقت التسليم، مفتاح الحدث أو العمل، نتيجة التحقق من التوقيع، حالة المعالجة، والتجزئة الخام المنقحة.
REST APIالطريقة، المسار، البيئة، معرف الطلب، رمز الرد، والمعلمات المنقحة.

لا تدرج أبدا كلمات المرور أو رموز الوصول أو أسرار API أو التوقيعات الكاملة أو المفاتيح الخاصة أو البيانات الشخصية غير المحجوبة في التشخيصات.

قبل التصعيد

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