لمن هذا — المدمجون المستقلون والشركاء الذين يبنون موصلات لخدمات خارجية. تشغّل كرزون طبقة الاستضافة — وأنت تقدّم التعريف والأصول الداعمة.
قبل التقديم
- مستند مكتمل — الهوية و
authوactionsو(إن وُجدت) كتلtriggersوwebhookوsyncوsourceوفق مخطط المستند. nsفريد — مساحة أسماء بحروف صغيرة بصيغة kebab-case (مثلmy-service). لا يمكن تغييره بعد الموافقة بدون تقديم جديد.- بيانات السوق الوصفية —
titleوالأوصاف وiconوlogoوcategoryوdocsUrl. انظر قائمة السوق. - أصول المزوّد — استضف
iconوlogoعلى روابط HTTPS تتحكم بها (SVG أو PNG). لا تستضيف كرزون أصول علامة الشركاء أثناء المراجعة. - بيانات اعتماد الاختبار — مفاتيح API لبيئة الاختبار أو تطبيق OAuth للمراجعين (انظر القائمة أدناه).
- رابط الويب هوك — وثّق نمط نقطة نهاية كرزون:
https://{tenant-api}/miniapps/{ns}/webhooks(يُوفَّر المضيف الدقيق أثناء التأهيل).
حزمة التقديم
أرسل إلى جهة اتصال شريك كرزون أوdevelopers@karzoun.chat:
عملية المراجعة
المدة المعتادة 5–10 أيام عمل حسب التعقيد (OAuth + ويب هوك + مزامنة تستغرق أطول من bearer-token + إجراءات).
بعد الموافقة
- يظهر ميني أبك في السوق ليثبّته المستأجرون.
- Redirect URI لـ OAuth لتسجيله لدى مزوّدك:
{SAAS_API_URL}/miniapps/{ns}/oauth2 - رابط الويب هوك الذي يسجّله المستأجرون:
{SAAS_API_URL}/miniapps/{ns}/webhooks - للتغييرات الكاسرة، زد
versionوقدّم مجدداً — لا تغيّرns.
تحديث ميني أب معتمد
- عدّل تعريف JSON محلياً.
- زد
version(semver). - قدّم الحزمة مجدداً مع سجل تغييرات قصير.
- تطرح كرزون بعد ضمان الجودة — تبقى التثبيتات الحالية تعمل ما لم توثّق خطوات الترحيل.
الخطوات التالية
- قائمة السوق — قائمة تحقق النصوص والوسائط
- استكشاف الأخطاء — مشاكل أثناء البناء محلياً
- أمثلة — تعريفات مرجعية