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

مشاكل قد تواجهها أثناء بناء تعريف ميني أب قبل أو أثناء مراجعة كرزون.

​

السوق والتقديم

ميني أب غير ظاهر بعد الموافقة

• كرزون وحدها تستطيع تعيين status: 'public' — أبقِ status: 'private' في مسودتك
• أكّد بريد الموافقة وns الصحيح في بحث السوق
• قد تكون تطبيقات الشركاء فقط مقيّدة بمستأجرين محددين

رفض التقديم بسبب أخطاء المخطط

• تحقّق من الحقول المطلوبة في مخطط المستند
• تأكد أن ns فريد وبحروف صغيرة وبصيغة kebab-case
• أدرج كل حقل سر في auth.sensitiveKeys

​

المصادقة

نافذة OAuth المنبثقة لا تُغلق

• يجب أن يكون Redirect URI بالضبط {SAAS_API_URL}/miniapps/{ns}/oauth2
• افحص وحدة تحكم المتصفح لأخطاء postMessage من نافذة OAuth

الإجراءات تُرجع 401 / يفشل test_token بـ 401

• تحقّق من ربط [[accessToken]] في get_token.mapping
• لـ OAuth، أكّد إعداد refresh_token وauto_refresh: true
• لـ HTTP Basic (Authorization: 'Basic [[user]]:[[pass]]')، أكّد أن وقت التشغيل يتضمن الترميز التلقائي لـ Basic — بدونه يُرسل user:pass خاماً ويرفض المزوّدون الطلب
• أكّد أن بيانات الاعتماد غير مبدّلة (مثلاً WooCommerce Consumer Key كاسم مستخدم وSecret ككلمة مرور)
• اختبر نفس الطلب بـ curl ببيانات اعتماد بيئة الاختبار: curl -u 'ck_…:cs_…' 'https://store.example/wp-json/wc/v3/orders?per_page=1'

​

الويب هوك والمشغّلات

الأتمتة لا تُفعَّل أبداً

• يجب أن يطابق triggers[].event السلسلة التي ينتجها webhook.eventExtraction تماماً
• سجّل رابط الويب هوك لدى المزوّد: {SAAS_API_URL}/miniapps/{ns}/webhooks
• فعّل التحقق من التوقيع فقط بعد تأكيد مسار حل السر

فشل التحقق من التوقيع

• أكّد أن secretKey يُحل من بيانات الاعتماد مقابل auth.config (عام مقابل لكل مستأجر)
• قارن بايتات الجسم الخام — JSON المُعاد تسلسله لن يطابق HMAC

​

مصادر RPC

القوائم المنسدلة فارغة

• اختبر رابط source.rpc_* يدوياً برمز صالح
• افحص dataPath وvalueField وlabelField مقابل JSON الحي
• وفّر x-fallback: 'input' حتى يتمكن المستخدمون من لصق المعرّفات عند فشل RPC

​

مزامنة التجارة الإلكترونية

الطلبات لا تظهر

• فضّل sync.webhooks.handlers على webhook.ecommerce القديمة
• يجب أن يكون recordType للمعالج order أو abandonedCart
• يجب أن يستخرج mapping.code معرّفاً خارجياً مستقراً
• تضمين حمولات ويب هوك عيّنة في تقديمك

​

الحصول على المساعدة

ضمّن في طلبات الدعم:

1. ns وversion لميني أب
2. تعريف JSON مُنقَّح
3. حمولة ويب هوك عيّنة واسم الحدث المتوقع
4. حساب بيئة اختبار المزوّد (إن وُجد)

التواصل: developers@karzoun.chat أو مدير شريك كرزون.