المتجر

"المتجر" هو الحاوية الأعلى مستوى للمنتجات والطلبات والعملاء. كل مفتاح مرتبط بـ متجر واحد فقط. لا توجد طريقة لاستعلام متاجر تجار آخرين.

`GET /v1/store`

تُرجع ملف المتجر الذي ينتمي إليه المفتاح المنادي.

المصادقة: مفتاح منصة بصلاحية store:read.

الطلب

curl https://api.dzbuild.app/v1/store \
  -H "Authorization: Bearer $DZ_KEY"

الاستجابة 200

{
  "data": {
    "id":         13,
    "name":       "DZBuild",
    "slug":       "dzbuild",
    "language":   "ar",
    "description": "DZBuild Offers Preview",
    "logo":       "/uploads/logos/13/8e19a05f0e4205bbcd861469ec0f9257.webp",
    "favicon":    null,
    "banner":     null,
    "theme": {
      "primary_color":    "#f59e0b",
      "secondary_color":  "#fbbf24",
      "background_color": "#ffffff",
      "font_family":      "Cairo"
    },
    "subdomain":            "dzbuild.minacef.app",
    "custom_domain":        null,
    "custom_domain_verified": false,
    "public_url":            "https://dzbuild.minacef.app",
    "hide_branding":         false,
    "created_at":            "2026-01-13 14:58:23"
  },
  "meta": { "request_id": "...", "api_version": "v1" }
}

مرجع الحقول

الحقل	النوع	ملاحظات
`id`	int	معرّف داخلي ثابت. يطابق `store_id` في كل المواضع الأخرى.
`name`	string	الاسم المعروض. يظهر في شريط واجهة المتجر والإيميلات.
`slug`	string	معرّف صالح للروابط. يُستخدم في `<slug>.dzbuild.app` وغيرها.
`language`	enum	`ar` أو `fr`. تحدد اتجاه الواجهة RTL/LTR.
`description`	string\|null	عبارة قصيرة.
`logo`	string\|null	مسار على `cdn.dzbuild.app` إن كان معيّنًا. ضع CDN الأساسي قبله إن أردت عرضه.
`favicon`	string\|null	نفس المنطق.
`banner`	string\|null	نفس المنطق.
`theme.primary_color`	hex string	لون الأزرار والإبرازات الأساسي.
`theme.secondary_color`	hex string	إبرازات ثانوية.
`theme.background_color`	hex string	خلفية الصفحة.
`theme.font_family`	string	الخط (الافتراضي `Cairo`).
`subdomain`	string\|null	النطاق الفرعي الصادر عن DZBuild (دائمًا حاضر).
`custom_domain`	string\|null	نطاق التاجر الخاص. يُعيَّن فقط إن أُضيف من لوحة التحكم.
`custom_domain_verified`	bool	true فقط عند اكتمال DNS و SSL.
`public_url`	string	حيث يصل العملاء فعلًا. يفضّل `custom_domain` إن تم التحقق منه.
`hide_branding`	bool	إخفاء "Powered by DZBuild" في الواجهة. لخطة غير محدود.
`created_at`	timestamp	وقت إنشاء المتجر بالتوقيت المحلي للخادم.

الأخطاء

HTTP	الكود	السبب
401	`unauthorized`	مفتاح خاطئ أو مفقود
403	`forbidden`	المفتاح يفتقر إلى `store:read`
404	`not_found`	حُذف صف المتجر أثناء استخدامك للمفتاح (نادر جدًا)

`PATCH /v1/store` (قادم في v1.1)

تحديث حقول ملف المتجر (الاسم، slug، ألوان الثيم، النطاق المخصص).

هذه النقطة محجوزة — السطح مقفل لكن التنفيذ ضمن إصدار v1.1. حتى ذلك الحين، التعديلات تتم من لوحة التحكم.

GET /v1/store​

الطلب​

الاستجابة 200​

مرجع الحقول​

الأخطاء​

PATCH /v1/store (قادم في v1.1)​