# DZBuild API reference (Arabic) > Reference for the DZBuild REST API v1: authentication, resources, webhooks and errors. Every link is the Markdown version of a page. All sections: https://dzbuild.com/ar/llms.txt ## General - [المصادقة](https://dzbuild.com/ar/api-docs/authentication.md): تعلّم كيفية المصادقة على طلبات الواجهة البرمجية باستخدام مفاتيح المنصة والمفاتيح العامة، بما في ذلك Bearer tokens وتواقيع HMAC للوصول الآمن إلى DZBuild API. - [سجل التغييرات](https://dzbuild.com/ar/api-docs/changelog.md): الواجهة البرمجية في مرحلة تجريبية. يجب أن تتبع مفاتيح API الشخصية متجراً ذا خطة Enterprise سارية، وإلا فكل نداء يُرجع 403؛ أما رموز التطبيقات المثبّتة فتعمل مع كل الخطط. وhttps://api.dzbuild.app هو المضيف الوحيد المدعوم. - [الأخطاء](https://dzbuild.com/ar/api-docs/errors.md): مرجع كامل لأكواد الأخطاء وأكواد HTTP وصيغة استجابة الأخطاء في DZBuild API وكيفية التعامل معها في تطبيقك. - [التكرار الآمن](https://dzbuild.com/ar/api-docs/idempotency.md): كل طلب POST أو PATCH أو DELETE إلى DZBuild API يتطلب رأس Idempotency-Key ويقبله PUT أيضًا، فلا تُنفَّذ عملية الكتابة مرتين عند إعادة المحاولة بالمفتاح نفسه. - [واجهة DZBuild البرمجية](https://dzbuild.com/ar/api-docs/intro.md): ابنِ على DZBuild — واجهة REST كاملة للمتاجر والمنتجات والطلبات والعملاء وصفحات الهبوط والاشتراكات وWebhooks. - [التصفّح والترقيم](https://dzbuild.com/ar/api-docs/pagination.md): تعرّف على كيفية استخدام DZBuild API للترقيم المعتمد على المؤشّر (cursor-based) في نقاط نهاية القوائم — جلب بيانات فعّال عبر next_cursor و has_more. - [DZBuild POS](https://dzbuild.com/ar/api-docs/pos.md): كيف يرتبط برنامج الصندوق المجاني DZBuild POS على ويندوز بالمتجر، والنداءات التي يرسلها للمنتجات والصور والمخزون ووثائق البيع والطلبات والزبائن وتدفق الأحداث. - [حدود المعدل](https://dzbuild.com/ar/api-docs/rate-limits.md): شرح حدود المعدل في DZBuild API — وصول حصري لخطة Enterprise، والسقف لكل متجر في الدقيقة، وميزانيات النقاط المكلفة، ولماذا لا تمسّ هذه الحدود واجهة متجرك أو لوحتك. ## guides - [اكتشاف الوكلاء](https://dzbuild.com/ar/api-docs/guides/agent-discovery.md): أين يجد وكلاء الذكاء الاصطناعي والمساعدون ملفات DZBuild الآلية وموصّل MCP ووصف REST API وكتالوج كل متجر، والقواعد التي يتبعونها. - [الثيمات والواجهات المخصصة](https://dzbuild.com/ar/api-docs/guides/custom-storefronts.md): ابنِ واجهة متجر مخصصة بالكامل بـ React أو Vue أو Next.js أو Flutter — مدعومة بواجهة DZBuild البرمجية. - [إعداد البيئة و .env](https://dzbuild.com/ar/api-docs/guides/env-setup.md): كيف تخزّن بيانات اعتماد DZBuild API بأمان في تطبيقك — من ملفات .env إلى KMS وحتى GitHub Secrets. - [للموزّعين](https://dzbuild.com/ar/api-docs/guides/resellers.md): كيف تستخدم DZBuild API لإعادة بيع المتاجر، إدارة العملاء على نطاق واسع، والتكامل مع back-office الخاص بك. ## public-key - [POST /v1/events](https://dzbuild.com/ar/api-docs/public-key/events.md): POST /v1/events — أحداث عامة يتتبعها التاجر (مشاهدات صفحة، عملاء محتملون، تحليلات مخصصة). نفس مخطط HMAC المستعمل في الاشتراكات، بدون إزالة تكرار email/phone. - [POST /v1/signups](https://dzbuild.com/ar/api-docs/public-key/signups.md): POST /v1/signups — حسب اشتراك مستخدم نهائي ضمن حصتك الشهرية. الوحدة الرئيسية القابلة للقياس. موقّعة بـ HMAC، تُقبل بشكل غير متزامن، يُزال تكرارها بـ nonce + email. ## resources - [الإحصائيات](https://dzbuild.com/ar/api-docs/resources/analytics.md): اقرأ أرقام لوحة التحكم لمتجر خلال فترة عبر GET /v1/analytics: الطلبات والإيرادات والربح والزوار ومعدل التحويل، مع نسبة التغيّر وبيانات الرسوم البيانية. - [الفئات](https://dzbuild.com/ar/api-docs/resources/categories.md): اعرض فئات منتجات متجرك واقرأها وأنشئها وأعد تسميتها وانقلها واحذفها ورتّبها من برنامجك الخاص، ثم تراجع عن إعادة تسمية أو نقل أو حذف. - [التغييرات والتراجع عنها](https://dzbuild.com/ar/api-docs/resources/changes.md): اعرض تغييرات الإعدادات التي أُجريت عبر الواجهة البرمجية، واقرأ أي تغيير مع القيم التي استبدلها، ثم تراجع عنه لتعود تلك القيم إلى المتجر. - [العملاء](https://dzbuild.com/ar/api-docs/resources/customers.md): اقرأ قائمة عملائك، ابحث برقم الهاتف أو البريد، اعرض كل طلبات عميل واحد. - [أقسام الصفحة الرئيسية](https://dzbuild.com/ar/api-docs/resources/home-layout.md): اقرأ أقسام الصفحة الرئيسية للمتجر وغيّرها من برنامجك الخاص بعشرة أنواع من الأقسام، فأضف قسماً أو عدّله أو أخفِه أو رتّب الأقسام أو احذفها أو تراجع عن تغيير. - [المفاتيح (مفاتيحك الخاصة)](https://dzbuild.com/ar/api-docs/resources/keys.md): أنشئ، اعرض، وألغِ مفاتيح الواجهة البرمجية لمتجرك. مفاتيح المنصة (Bearer) والمفاتيح العامة (HMAC). - [صفحات الهبوط](https://dzbuild.com/ar/api-docs/resources/landing-pages.md): CRUD لصفحات الهبوط — صفحات تحويل لمنتج واحد بأقسام (سلايدرات، نماذج طلب، زوار وهميون، عدّاد تنازلي، عروض خاصة). - [قوائم المتجر](https://dzbuild.com/ar/api-docs/resources/menus.md): اقرأ روابط شريط التنقل وتذييل المتجر واستبدلها من برنامجك الخاص كوثيقة واحدة مع فحص النسخة، ثم تراجع عن تعديل أو أرجع الروابط التلقائية. - [الطلبات](https://dzbuild.com/ar/api-docs/resources/orders.md): إنشاء وقراءة الطلبات والانتقال بين حالاتها وإلغاؤها. دعم كامل للمتغيرات، سلال متعددة الأسطر، تسعير معتمد على الخادم. - [صفحات المتجر](https://dzbuild.com/ar/api-docs/resources/pages.md): اعرض صفحات متجرك المكتوبة بلغة Markdown واقرأها وأنشئها وعدّلها واحذفها من برنامجك الخاص، مثل من نحن أو الإرجاع، ثم تراجع عن تعديل أو حذف. - [بيكسلات التتبع](https://dzbuild.com/ar/api-docs/resources/pixels.md): اعرض بيكسلات التتبع الخاصة بالمتجر وأضفها وعدّلها واحذفها من برنامجك، لمنصات Meta وTikTok وSnapchat وPinterest وGoogle. توكن الوصول يُكتب ولا يُقرأ. - [المنتجات](https://dzbuild.com/ar/api-docs/resources/products.md): CRUD كامل لكتالوج المنتجات — قائمة، تفاصيل، إنشاء، تعديل، حذف. مع المتغيرات والصور وحدود الخطة. - [الرموز الترويجية](https://dzbuild.com/ar/api-docs/resources/promo-codes.md): اعرض الرموز الترويجية لمتجرك وأنشئها وعدّلها واحذفها من برنامجك الخاص، مع شرط تفعيل الإضافة وتأكيد خصم 100% والتراجع عن التغييرات. - [الحصص](https://dzbuild.com/ar/api-docs/resources/quotas.md): اعرض حدود خطة Enterprise، أي تجاوزات خاصة بمتجرك ضبطها الدعم، وحدودك الفعّالة. - [الشحن](https://dzbuild.com/ar/api-docs/resources/shipping.md): اقرأ أسعار التوصيل لكل ولاية وقواعد الشحن المجاني وعدّلها، واربط شركات التوصيل واختبرها وزامن أسعارها، وتحقق من تغطيتها، واعرض قوائم الولايات والبلديات. - [المتجر](https://dzbuild.com/ar/api-docs/resources/store.md): GET /v1/store — ملف متجرك (الاسم، slug، الثيم، النطاق المخصص، الرابط العام). - [القوالب](https://dzbuild.com/ar/api-docs/resources/themes.md): اعرض قوالب واجهة المتجر وقوالب نموذج الطلب السريع وأنماط اختيار المتغيرات التي يستطيع المتجر استعمالها، ثم بدّل كل واحد منها من برنامجك الخاص. - [الاستخدام](https://dzbuild.com/ar/api-docs/resources/usage.md): اعرض استهلاك واجهتك البرمجية لهذا الشهر والتجميعات الساعية التاريخية. - [رسائل واتساب](https://dzbuild.com/ar/api-docs/resources/whatsapp.md): اقرأ قوالب رسائل واتساب الخاصة بالطلبات ورصيد واتساب للمتجر وسجل الرسائل المرسلة، وأرسل قالباً معتمداً لزبون طلب معيّن من برنامجك الخاص. ## webhooks - [كتالوج الأحداث](https://dzbuild.com/ar/api-docs/webhooks/events.md): كل أحداث webhook التي يمكن لـ DZBuild إطلاقها، مع شكل حقل البيانات لكل واحد بالضبط. - [Webhooks](https://dzbuild.com/ar/api-docs/webhooks/overview.md): كيف تعمل webhooks في DZBuild — الأحداث التي تُطلق، آلية التسليم وإعادة المحاولة، نموذج الأمان، والحصص. - [تسجيل webhook](https://dzbuild.com/ar/api-docs/webhooks/registering.md): أنشئ، اسرد، اختبر، واحذف اشتراكات webhook لمتجرك. - [التحقق من التواقيع](https://dzbuild.com/ar/api-docs/webhooks/verifying-signatures.md): كيفية مصادقة webhooks الواردة من DZBuild. مقارنة HMAC بزمن ثابت + فحص حداثة، مع كود جاهز للنسخ بـ Node.js و PHP و Python و Go.