إنتقل إلى المحتوى الرئيسي

واجهة DZBuild البرمجية صارت live — ابنِ تكاملات مخصصة لمتجرك

· 3 دقائق قراءة
DZBuild Team
DZBuild Team
نحن نبني المنصة

اليوم نُطلق DZBuild API v1 للعموم. مفتاح، توثيق، أمثلة، كل شيء في انتظارك.

ما يمكنك بناؤه​

  • واجهات headless — متجر React/Vue/Next.js يتحدث بالكامل عبر API.
  • أتمتة back-office — مزامنة طلبات لـ CRM، استيراد منتجات بالجملة، تأكيد بالجملة.
  • تطبيقات جوال — iOS / Android بإدارة طلبات وإشعارات.
  • تكاملات شركاء — ربط Zapier، n8n، Make، أي منصة أتمتة.
  • منصات Reseller — وكالات تدير عشرات متاجر العملاء من back-office واحد.

بداية سريعة​

عنوان القاعدة​

https://api.dzbuild.app/v1

المصادقة​

Authorization: Bearer dzpk_live_<key_id>.<secret>

أنشئ أول مفتاح​

من لوحة التحكم: الإعدادات ← API عبر الصفحة /dashboard/api — متاحة لمالك المتجر على خطة Enterprise، والسر يظهر مرة واحدة فقط عند الإنشاء فاحفظه.

ما في v1​

الموارد الأساسية​

  • /v1/store — بيانات المتجر
  • /v1/products — CRUD كامل للمنتجات
  • /v1/orders — إنشاء، قراءة، انتقال حالة، إلغاء
  • /v1/customers — قراءة العملاء وطلباتهم
  • /v1/landing-pages — CRUD لصفحات الهبوط
  • /v1/keys, /v1/usage, /v1/quotas — الإدارة

نقاط المفتاح العام​

  • /v1/signups — تتبع اشتراكات عالي الحجم بـ HMAC
  • /v1/events — أحداث عامة

Webhooks​

  • 10 أحداث: order.*, payment.received, signup.counted, event.recorded, product.stock_low, webhook.test
  • التواقيع HMAC-SHA256، مع إعادة محاولة تلقائية عند فشل التسليم.

مثال: إنشاء منتج​

curl -X POST 'https://api.dzbuild.app/v1/products' \
  -H "Authorization: Bearer $DZ_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "name":"T-shirt", "price":1500, "status":"active" }'

مثال: سرد الطلبات​

curl 'https://api.dzbuild.app/v1/orders?status=pending&limit=20' \
  -H "Authorization: Bearer $DZ_KEY"

كيف تتصرّف الطلبات​

الـ API مخدوم من شبكة عالمية، فزمن الاستجابة يبقى منخفضًا من أي مكان تنادي منه:

  • الطلب بلا مفتاح صالح (أو بلا توقيع HMAC صالح للمفتاح العام) يُرفض بـ 401 قبل أي معالجة.
  • حد معدل لكل مفتاح؛ تجاوزه يُعيد 429 مع retry_after.
  • قراءات GET الآمنة قد تُخدَّم من الذاكرة المؤقتة حتى 30 ثانية.
  • النقاط عالية الحجم (/v1/signups, /v1/events) تُعيد 202 فورًا وتُكمل المعالجة لاحقًا.

مظروف الاستجابة​

{ "data": ..., "meta": { "request_id": "...", "api_version": "v1" } }

حدود المعدل​

الخطةطلبات/دقيقةطلبات/شهر
Free3010K
Pro300500K
غير محدود API12005M
Enterprise6000+بلا حدود

Idempotency​

كل POST/PATCH/DELETE يتطلب Idempotency-Key. الإعادة بنفس المفتاح خلال 24 ساعة = نفس الاستجابة.

التصفّح​

ترقيم بمؤشّر — cursor + next_cursor + has_more.

SDKs والمكتبات​

  • مرجع TypeScript / Node.js (قادم من DZBuild)
  • مكتبة Python (community)
  • مكتبة PHP (community)

البدء​

توثيق API الكامل

أمثلة عملية​

مزامنة منتجات من CSV​

for row in csv.DictReader(f):
    requests.post('https://api.dzbuild.app/v1/products', json=row, headers={...})

معالج Webhook​

app.post('/webhook', verifySignature, (req, res) => {
  if (req.body.event === 'order.created') notifyCRM(req.body.data);
  res.status(200).end();
});

الدعم​

  • توثيق: dzbuild.com/api-docs
  • بريد: [email protected]
  • تيليجرام: t.me/dzbuild

التسعير​

API مشمول في خطط Pro فما فوق. في فترة pilot (الآن) لا يحاسَب الاستهلاك. التسعير النهائي يُعلن عند الخروج من pilot.

التالي​

  • v1.1: سعر الشحن من GET /v1/store، تركيبات المنتج، روابط رفع صور presigned، استرداد الطلبات.
  • v1.2: SDK رسمية بـ Node و Python.

ابنِ الآن​

أنشئ مفتاحك من اللوحة، اقرأ التوثيق، وابدأ.