للمطوّرين والشركات

ابنِ تطبيقك على DEPZO

شركة شحن، محاسبة، تسويق أو أي خدمة؟ اربط متاجر DEPZO بنظامك، والتاجر يركّبك بضغطة.

سجّل شركتك مجاناًاقرأ الشرح
كل متاجر DEPZO

تطبيقك يطلع في «كل التطبيقات» عند كل تاجر

ربط بموافقة

التاجر يشوف صلاحياتك ويوافق بضغطة، بدون ما ينسخ مفاتيح

إشعارات لحظية

طلب جديد أو حالة تغيّرت توصلك موقّعة

بدون رسوم

التسجيل والنشر مجاني

الشرح للمبرمج

1. سوّ تطبيقك

من بوابة المطوّرين: الاسم، رابط الرجوع، الصلاحيات. تاخذ Client ID وسر. ومعك متجر تجربة فيه منتجات تجرّب عليه.

2. ودّ التاجر لصفحة الموافقة

GET https://depzo.ae/oauth/authorize
  ?client_id=dzc_...
  &redirect_uri=https://your-app.com/depzo/callback
  &scope=read_orders write_orders
  &state=RANDOM

بعد ما يوافق، نرجعه لرابطك ومعه code وstate واسم متجره store. الرمز ينفع مرة وحدة لعشر دقايق.

3. بدّل الرمز بالتوكن

curl -X POST https://depzo.ae/api/oauth/token \
  -d grant_type=authorization_code -d code=CODE \
  -d client_id=dzc_... -d client_secret=dzs_... \
  -d redirect_uri=https://your-app.com/depzo/callback

{ "access_token": "dz_...", "token_type": "bearer", "scope": "read_orders write_orders",
  "store": { "id": 7, "slug": "ward", "currency": "AED", "url": "...", "api": "https://depzo.ae/api/v1" } }

4. استخدم الـAPI

curl "https://depzo.ae/api/v1/orders?status=paid" -H "Authorization: Bearer dz_..."
curl https://depzo.ae/api/v1/orders/1042
curl -X PATCH https://depzo.ae/api/v1/orders/1042 -d '{"status":"shipped"}'
curl "https://depzo.ae/api/v1/products?limit=50&offset=0"
curl -X PATCH https://depzo.ae/api/v1/products/12 -d '{"stock":30,"price":99.5}'
curl https://depzo.ae/api/v1/customers
read_productsتشوف المنتجات: الأسماء والأسعار والمخزون والصور
write_productsتعدّل المنتجات: الأسعار والمخزون
read_ordersتشوف الطلبات: الطلبات وعناوين الشحن فيها
write_ordersتغيّر حالة الطلب: مثلاً: انشحن، وصل
read_customersتشوف العملاء: الأسماء والجوالات والبريد

5. الإشعارات

حط رابط الإشعارات في تطبيقك واختر الأحداث. كل خبر POST بـJSON وموقّع: X-Depzo-Signature = HMAC-SHA256 (hex) للنص بسر الإشعارات. لو رابطك ما رد 2xx نعيد المحاولة 5 مرات.

order.newطلب جديد
order.statusحالة طلب تغيّرت
booking.newحجز جديد
booking.statusحالة حجز تغيّرت
{ "event": "order.status", "store": { "id": 7, "slug": "ward" }, "id": 6354, "number": 6354, "from": "paid", "to": "shipped", "at": "..." }

// Node
const ok = crypto.createHmac('sha256', WEBHOOK_SECRET).update(rawBody).digest('hex') === req.headers['x-depzo-signature'];

6. قدّمه للمراجعة

نراجعه، ولما ينتشر يطلع لكل التجار في «كل التطبيقات ← تطبيقات الشركات». لو التاجر فصل تطبيقك، التوكن يوقف على طول.

عندك ربط جاهز مع ووكومرس؟ متاجر DEPZO ترد بشكل ووكومرس بعد (/wp-json/wc/v3).