البدء بتطبيق ساس

يصف هذا الدليل تسلسل الإعداد المنفذ. السوق معطلة في سياسة الإصدار الحالية؛ استخدم بيئة اختبار مفعلة ومصرحاً بها فقط.

1. أنشئ حساب مطور

سجل من وحدة المطورين بعد المصادقة. لحساب المطور دورة مستقلة بحالتي active وsuspended، وهو ليس دوراً ضمن فريق التاجر. تعتمد الإتاحة على تفعيل ميزة السوق للبيئة.

2. أنشئ التطبيق وإصداره الأول

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

3. أرسل الإصدار للمراجعة

أرسل الإصدار؛ فالمراجعة تتم لكل إصدار على حدة. يستطيع Super Admin الموافقة أو الرفض، ثم نشر الإصدار الموافق عليه. يستطيع Support الاطلاع على بيانات المراجعة، لكنه لا يوافق أو يرفض أو ينشر أو يعلق أو يثبت نيابة عن التاجر.

4. اختبر بأمان

استخدم نموذج التجهيزات المحلية في المستودع وبيانات تاجر اصطناعية. بيئة الاختبار الخارجية المستضافة PLANNED. لا تستخدم رموز الإنتاج أو سجلات التجار أو بيانات اعتماد المزودين للتطوير. اختبر عزل المستأجرين ورفض النطاقات والترقيم وحدود المعدل والتحقق من توقيع Webhook.

5. ثبّت التطبيق وفوضه

ابدأ رحلة GET الموثقة للتفويض. يسجل مالك المتجر أو مديره الدخول ويختار متجراً مؤهلاً ويوافق على مجموعة من صلاحيات الإصدار المراجع بعينه. بادل رمز التفويض ذي الاستخدام الواحد باستخدام S256. يبقى تفعيل الإصدار PARTIAL؛ استخدم بيئة اختبار مصرحاً بها وعقد OAuth العام، دون استدعاء RPCs خاصة.

6. نفذ أول طلب API

بعد أن ينتج تثبيت اختباري مصرح به رمز وصول، أرسله من خادمك في Authorization: Bearer <ACCESS_TOKEN>. ابدأ بإحدى عمليات API v1 الخمس الموثقة. لا يوجد client secret. خزّن رمزي الوصول والتحديث في الخادم واحجبهما من السجلات.

curl --request GET \
  --header "Authorization: Bearer <ACCESS_TOKEN>" \
  "https://example.com/api/v1/catalog/products?limit=25"

7. أضف Webhooks عند الحاجة فقط

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