واجهة DZBuild البرمجية

تتيح لك واجهة DZBuild البرمجية إدارة متجرك برمجيًا: المنتجات، الطلبات، العملاء، صفحات الهبوط، بالإضافة إلى متتبع اشتراكات عالي الحجم للتجار الذين يدمجون DZBuild في منصاتهم الخاصة.

عنوان القاعدة: https://api.dzbuild.app/v1 الإصدار: مستقر على v1. أي تغييرات جذرية تتطلب بادئة مسار جديدة. التنسيق: JSON دخولًا وخروجًا، بترميز UTF-8. المصادقة: انظر المصادقة. الحالة: تجريبي (Pilot). أنشئ مفتاحًا من لوحة التحكم بمجرد توفّر الميزة، أو راسل support@dzbuild.com للانضمام إلى البرنامج التجريبي.

بداية سريعة

curl https://api.dzbuild.app/v1/ping

الاستجابة:

{ "data": { "pong": true, "time": "2026-04-30T20:15:59.836Z", "edge": true },
  "meta": { "request_id": "...", "api_version": "v1", "edge": true } }

طلب موثَّق:

curl https://api.dzbuild.app/v1/whoami \
  -H "Authorization: Bearer dzpk_live_<your_key_id>.<your_secret>"

بنية الاستجابة

كل الاستجابات تتبع الشكل ذاته:

نجاح

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

خطأ

{ "error": { "code": "rate_limited", "message": "...", "retry_after": 12 },
  "meta": { "request_id": "...", "api_version": "v1" } }

البنية التقنية

تصل الطلبات إلى Cloudflare Workers على الحافة في أكثر من 300 نقطة تواجد:

• مصادقة + تحقق HMAC على الحافة — لا تصل أي طلبات غير موثَّقة إلى الخادم الأصلي.
• حد معدل لكل مفتاح بنافذة زمنية منزلقة على الحافة.
• ذاكرة قراءة مؤقتة (30 ثانية) لطلبات GET الآمنة.
• الكتابات تُمرَّر إلى الخادم الأصلي مع رؤوس تصديق الحافة؛ والخادم يتحقق مجددًا.
• الكتابات عالية الحجم (/v1/signups, /v1/events) تمر عبر Cloudflare Queues وتُرجع 202 Accepted فورًا — نداؤك لا ينتظر قاعدة البيانات.