# سجل التغييرات

تسرد هذه الصفحة التغييرات المؤرّخة على منصة مطوّري `DZBuild`. التغييرات على واجهة `REST` الخاصة بالتجار التي لا تخص التطبيقات موجودة في [سجل تغييرات الواجهة البرمجية على dzbuild.com](https://dzbuild.com/ar/api-docs/changelog).

## 2026-09-26: إطلاق المنصة[​](#2026-09-26-إطلاق-المنصة "رابط مباشر إلى 2026-09-26: إطلاق المنصة")

أصبحت تطبيقات الأطراف الخارجية متاحة للمطورين. يتضمن هذا الإصدار:

* **منصة المطورين** في `https://dzbuild.com/dashboard/developer`. سجّل تطبيقاً، واحصل على `client_id` وسرّ العميل ومفتاح التوقيع، وجدّد السرّين، وجرّب على متاجرك، وأرسل التطبيق للمراجعة.
* **مسار التثبيت**: `OAuth 2.0` بنوع `authorization code` مع `PKCE` بطريقة `S256` فقط. يعرض `GET /oauth/apps/authorize` شاشة الموافقة، ويعيد `POST /oauth/apps/token` رموز التثبيت. موافقة واحدة تشمل 10 متاجر كحد أقصى يملكها التاجر. راجع [OAuth](https://dzbuild.dev/ar/ar/oauth.md).
* **رموز التثبيت**: رمز `Bearer` واحد يبدأ بـ `dzpk_live_` لكل متجر، محدود بالصلاحيات الموافق عليها، دون تاريخ انتهاء. إزالة التطبيق تلغيه. يمكن لأي خطة متجر تثبيت تطبيق، واضبط `min_plan` لتشترط خطة أعلى.
* **19 صلاحية** للتطبيقات، تغطي المتجر والمنتجات والطلبات والتوصيل والعملاء وصفحات الهبوط وأكواد التخفيض والبكسلات والشحن والإحصائيات و`WhatsApp`. الصلاحية `ai:generate` غير متاحة للتطبيقات. راجع [الصلاحيات](https://dzbuild.dev/ar/ar/scopes.md).
* **كائن التطبيق في `GET /v1/whoami`**: `app_id` و`client_id` و`install_id` للطلبات المنفّذة برمز تثبيت.
* **حدّ معدّل لكل تثبيت** قدره 120 طلباً في الدقيقة، يُفحص قبل الحدّ المشترك للمتجر. راجع [حدود معدّل الطلبات](https://dzbuild.dev/ar/ar/rate-limits.md).
* **أخطاء التطبيقات**: `403` مع `app_uninstalled` أو `app_suspended` أو `app_not_approved` أو `app_plan_required`. رموز التثبيت تحصل على `403` في `/v1/keys` و`/v1/webhooks` و`/v1/changes`.
* **إشعارات `webhook` للتطبيقات**: أحداث الطلبات و`app.uninstalled`، موقّعة بـ `X-DZ-Signature`. أحداث الطلبات تتطلب الصلاحية `orders:read`. راجع [إشعارات webhook](https://dzbuild.dev/ar/ar/webhooks.md).
* **رابط الفتح**: يعيد زر الفتح لدى التاجر التوجيه إلى رابط الفتح الخاص بك مع رمز موقّع بـ `HS256` في `dz_launch`، صالح 5 دقائق.
* **واجهة `WhatsApp`**: `GET /v1/whatsapp/templates` و`GET /v1/whatsapp/balance` و`GET /v1/whatsapp/messages` و`POST /v1/orders/{id}/whatsapp`، بالصلاحيتين `whatsapp:read` و`whatsapp:send`. راجع [واجهة WhatsApp](https://dzbuild.dev/ar/ar/whatsapp.md).
* **وصف OpenAPI** للواجهة `/v1` العلنية، قابل للتنزيل من [مرجع الواجهة البرمجية](https://dzbuild.dev/ar/ar/api-reference.md).