ابدأ خلال 15 دقيقة

توثيق مطوّري دكان

ابنِ تطبيقاً أو ثيماً على دكان خلال 15 دقيقة، ثم تعمّق في المراجع.

ابنِ تطبيقاًسجّل التطبيق، واحصل على رمز OAuth، واستدعِ الواجهة البرمجية، واستقبل Webhook موقّعاً.15 دقيقة ابنِ ثيماًأنشئ الهيكل بأداة CLI، وعاينه على متجر تجريبي، وانشر قوالب Liquid عربية أولاً.15 دقيقة

تبني على دكان أحد شيئين: تطبيقاً يقرأ ويكتب بيانات متاجر التجّار عبر واجهة REST محمية بنطاقات ويستقبل الأحداث عبر Webhooks موقّعة، أو ثيماً بقوالب Liquid تُصيَّر على خوادم دكان بلا أي JavaScript. كلاهما يبدأ من متجر تجريبي وينتهي في السوق.

ابدأ خلال 15 دقيقة#

المسار	ما ستنفّذه	ابدأ
تطبيق	تسجيل التطبيق، رمز وصول عبر OAuth، أول استدعاء لـ `GET /orders`، أول Webhook	ابنِ تطبيقاً
ثيم	`theme init` ثم `login` ثم `theme dev`، وقالب صحيح من ملفين	ابنِ ثيماً
متجر تجريبي	بيانات جاهزة بكل الحالات الحدّية، وإعادة التهيئة	المتاجر التجريبية

مفاهيم يجب أن تعرفها#

المال بالوحدات الصغرى — المال أعداد صحيحة دائماً، وdecimals يأتي من الاستجابة لا من جدول ISO.
دورة حياة الدفع عند الاستلام — التسليم والدفع حدثان منفصلان؛ order.paid يصدر من دفتر المدفوعات.
مرجع النطاقات — كل نقطة نهاية وكل موضوع Webhook يتطلب نطاقاً محدداً؛ clients:read خلف اتفاقية معالجة البيانات.

المراجع#

مرجع الواجهة البرمجية — الأعراف، ثم كل عملية مع أمثلة الطلب والاستجابة.
كائنات Liquid · المرشّحات · الوسوم · الحدود
مرجع أداة الثيمات

البرنامج#

الأرباح والتحويلات · معايير مراجعة التطبيقات · معالجة البيانات · شروط المطوّرين · الدعم

آخر التغييرات#

2026-08 — عقد الثيمات: أقسام على صفحات المنتج والتصنيف والسلة، والنوعان datetime وrichtext، ومرشّحات money_major وdate_localized وfile_alt وfile_focal_style، والغلاف المنصّي للأقسام. التفاصيل في سجل التغييرات.

أدلة شائعة

Webhooksالغلاف، والتحقق من التوقيع بأربع لغات، ودلالات التسليم وإعادة المحاولة، والمواضيع.التفويضOAuth 2.1 مع PKCE، والرموز، ومنحة التحديث، والإلغاء، وجدول الأخطاء.المال بالوحدات الصغرىأعداد صحيحة دائماً، وجدول العملات، وتنسيق العرض، ومطابقة الدفاتر، وتعدد العملات.بنية الحزمةالملفات المطلوبة، وعقد الهيكل والكتلة، والمسارات المحجوزة، وقواعد CSS والأصول.الأقسام والكتلإعلان الأقسام، وموزّع الأجسام، والتصيير المزدوج، والأشرطة، ومصادر المنتجات، ووحدات منصّة التشغيل.المتاجر التجريبيةما يحتويه المتجر التجريبي، وكيف تعيد تهيئته، وحدوده.

المراجع

مرجع الواجهة البرمجيةأعراف واجهة المنصّة: العنوان الأساسي، والمصادقة، وIdempotency-Key، والتصفّح، والحدود، والترويسات، والإصدارات، والأخطاء، وسياسة البيانات الشخصية.مرجع حزمة التطبيقاتكل رمز عام في @dukkan.one/app-sdk، صفحة لكل نقطة دخول، مولَّد من أنواع الحزمة نفسها.كائنات Liquidكل مفتاح في سياق التصيير v1 مع خصائصه وأنواعه ومتى يكون حاضراً.مرشّحات Liquidالمرشّحات الـ16 التي تسجّلها المنصّة: التوقيع، والمدخل والمخرج، ومثال، وملاحظات الاتجاه.وسوم Liquidالوسوم المتاحة، وقواعد layout وblock وinclude، وما يُرفض، وتحذير الحالة داخل الأقسام.الحدودحدود الحزمة والتصيير والمخطط ومستند الإعدادات في مكان واحد.مرجع الأداةكل أمر في @dukkan.one/cli للثيمات والتطبيقات مع خياراته، ورموز الخروج، ومخرجاته، وملفاته، ومتغيرات البيئة، وحلّ المشكلات.