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

ابنِ تطبيقات تعمل مع أي متجر على فَز

مصادقة OAuth 2.0

1
التاجر يضغط 'تثبيت' في متجر التطبيقات
2
فَز يعيد التوجيه لـ redirect_url مع authorization code
3
تطبيقك يستبدل الكود بـ access_token
4
استخدم الـ token للوصول للـ API

الصلاحيات (Scopes)

ScopeAccess
read_productsProduct catalog, variants, inventory
write_productsCreate, update, delete products
read_ordersOrder list, details, status
write_ordersUpdate order status, add notes
read_customersCustomer profiles and addresses
read_storeStore info, settings, policies
write_storeUpdate 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 });
});