بناء التطبيقات على المنصة الحالية

ابنِ تكاملاً خادمياً فوق الحد العام. تعامل مع كل قدرة حسب حالتها الموثقة، وصمم التطبيق بأقل صلاحية وفشل محدود ومن دون معرفة بالطوبولوجيا الداخلية.

القدرات المدعومة والجزئية

تعمل قراءة العملاء والمخزون والخصومات وبيانات المتجر وفق الحقول الموثقة. كتابة المنتجات والخصومات والطلبات ما زالت PLANNED. أما تعديل مزود الدفع أو الشحن أو الرسائل وامتدادات الذكاء الاصطناعي والأتمتة والواجهة والقالب وحزم SDK الرسمية فهي DEFERRED.

هوية التطبيق وslug

التطبيق هو هوية ثابتة يملكها الناشر. يستخدم slug أحرفاً لاتينية صغيرة وأرقاماً وشرطات ويبقى فريداً. يجب أن تكون أسماء العرض والأوصاف بالعربية والإنجليزية. لا تستخدم هوية التطبيق لانتحال ساس أو التاجر.

بيانات الإصدار المحدد

تُراجع كل نسخة دلالية من التطبيق بصورة مستقلة. يصرح بيانها بعناوين إعادة توجيه مطابقة حرفياً ونطاقات مطلوبة وأسماء أحداث Webhook وملاحظات إصدار باللغتين. العناوين قيم محددة وليست أنماطاً. استخدم HTTPS خارج التطوير المحلي المنضبط.

النطاقات المطلوبة

اطلب أصغر مجموعة تحتاجها العمليات الحالية فعلاً. تبقى ثلاثة نطاقات كتابة مسجلة بلا مسار عام. إدراجها في البيان لا ينشئ نقطة نهاية ولا يسمح بوصول خاص. تتطلب النطاقات الجديدة إصداراً جديداً خاضعاً للمراجعة ومنحة من التاجر؛ ولا تضاف بصمت إلى تثبيت قائم.

تصريحات Webhook

يحدد تصريح Webhook الأحداث التي يمكن للتطبيق استقبالها. استخدم عقد أحداث الموارد الموثق، وأظهر للتاجر الأحداث المراجعة فقط. تعامل مع التكرار وانتهاء المهلة واحتمال حذف المورد المشار إليه. اجتاز السوق قبول المختبر الخاص؛ يخضع كل إصدار لنطاق تشغيله.

تصميم يراعي دورة الحياة

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