دليل بناء التطبيقات
ابنِ تطبيقات تعمل مع أي متجر على فَز
مصادقة OAuth 2.0
1
التاجر يضغط 'تثبيت' في متجر التطبيقات2
فَز يعيد التوجيه لـ redirect_url مع authorization code3
تطبيقك يستبدل الكود بـ access_token4
استخدم الـ token للوصول للـ APIالصلاحيات (Scopes)
| Scope | Access |
|---|---|
| read_products | Product catalog, variants, inventory |
| write_products | Create, update, delete products |
| read_orders | Order list, details, status |
| write_orders | Update order status, add notes |
| read_customers | Customer profiles and addresses |
| read_store | Store info, settings, policies |
| write_store | Update store settings |
أنواع التطبيقات
تطبيقات واجهة
Script Tags و App Blocks في واجهة المتجر
تطبيقات خلفية
Webhooks + API لمعالجة البيانات
مثال: تطبيق Upselling
// 1. Listen for order.created webhook
app.post("/webhooks/order", async (req, res) => {
const order = req.body.data;
// 2. Fetch related products via Fez API
const products = await fez.products.getRelated(order.items);
// 3. Send upsell email to customer
await sendUpsellEmail(order.customer.email, products);
res.json({ ok: true });
});