سجل واحد لكل جهة
GET /api/v1/brands/{slug} يعيد سجل جهة منشورة: هويتها اليوم في currentVersion، وتاريخها في versions، وبياناتها حولها. الجهة غير المنشورة لا سجل لها، فتعيد 404.
slug ثابت للجهة، وهو عنوان صفحتها في الأرشيف: /brands/{slug}.
ما قد يغيب
الأرشيف يُبنى جهةً جهة، وليست كل جهة مكتملة:
| حين يغيب | يأتي |
|---|---|
| نص أو رقم غير معروف | null |
| الاسم الإنجليزي | name.en: null |
| الشعار | currentVersion: null، أو logo: null |
| الألوان | colors: [] وcolorsSource: null |
| الحسابات | social: {} |
لا تعرض null نصًا، ولا تملأ الفراغ بتخمين: اسم بلا شعار أصدق من شعار مختلق.
الحقول كلها
كل حقل بنوعه ووصفه في مرجع السجل.