سجل جهة

GET/api/v1/brands/{slug}

كل ما ينشره الأرشيف عن علامة: أسماؤها، وتصنيفها، وألوانها ومصدرها، وخطوطها، والنسخة الحالية بملفاتها، وتاريخ نسخها، وأدلة هويتها. الحقول التي لا يعرفها الأرشيف تأتي null أو مصفوفة فارغة، ولا تُحذف من الاستجابة.

المفتاح: مطلوب في ترويسة Authorization. كل استجابة ناجحة تُحسب سحبًا من حد الشهر.
حدود الطلبات: بمفتاح: حد باقتك في الدقيقة. بلا مفتاح: 30 طلبًا كل 60 ثانية لكل عنوان IP.
التخزين المؤقت: private, no-store
CORS: يُقرأ من أي موقع (CORS)

المعاملات

slug
stringفي المسارمطلوب
المعرّف النصي للعلامة، كما يأتي في slug من البحث أو القائمة. العنوان القديم لعلامة غيّرت عنوانها يحوّل إلى الجديد.
غير الموجود يعيد 404

الاستجابة

slugstring
المعرّف النصي، وهو عنوان صفحتها: /brands/:slug.
name{ ar: string, en: string | null }
الاسم باللغتين. en قد يكون null.
description{ ar: string | null, en: string | null }
نبذة عن الجهة، إن كُتبت.
countrystring | null
رمز الدولة من حرفين.
city{ ar: string | null, en: string | null }
المدينة.
categoryobject | null
القطاع، أو null.
- slugstring
  المعرّف النصي.
- name{ ar: string | null, en: string | null }
  الاسم باللغتين.
industryobject | null
الصناعة، أو null.
- slugstring
  المعرّف النصي.
- name{ ar: string | null, en: string | null }
  الاسم باللغتين.
entityTypestring | null
نوع الجهة: حكومية، شركة، جامعة، فعالية…
governmentsemi_governmentprivate_companynonprofituniversitysportseventcampaignproductmediaprogramother
websitestring | null
موقع الجهة، إن عُرف.
socialobject
حساباتها بأسماء المنصات (x وinstagram وlinkedin…)؛ ما لا يُعرف لا يظهر.
مفاتيح بأسماء المنصات
foundedYearinteger | null
سنة التأسيس.
verifiedboolean
true حين تكون الجهة موثّقة رسميًا.
aliasesarray<string>
أسماء أخرى تُعرف بها، حتى 12.
colorsarray<object>
ألوان الشعار من مصدر واحد: المحرر، ثم دليل الهوية، ثم المستخرج آليًا. حتى 8 ألوان.
- hexstring
  اللون بصيغة #RRGGBB.
- rolestring | null
  دوره: أساسي أو ثانوي أو مميز أو محايد أو خلفية.
  primarysecondaryaccentneutralbackgroundother
- name{ ar: string | null, en: string | null }
  اسمه، إن سُمّي.
- sourcestring | null
  من أين جاء: المحرر، أو دليل الهوية، أو استخراج آلي من الملف، أو الأرشيف القديم.
  extractedguidelineseditorlegacy
colorsSourcestring | null
مصدر colors كلها؛ null حين لا توجد ألوان.
extractedguidelineseditorlegacy
identityColorsarray<object>
ألوان الهوية كما يحددها دليلها، بقيمها للطباعة. غير ألوان الشعار.
- hexstring
  اللون بصيغة #RRGGBB.
- rolestring | null
  دوره: أساسي أو ثانوي أو مميز أو محايد أو خلفية.
  primarysecondaryaccentneutralbackgroundother
- name{ ar: string | null, en: string | null }
  اسمه، إن سُمّي.
- rgbstring | null
  قيمة RGB كما في الدليل، نصًا.
- cmykstring | null
  قيمة CMYK كما في الدليل، نصًا.
- pantonestring | null
  رقم Pantone، إن ذُكر.
- proportionnumber | null
  نسبة حضوره في الهوية، من 0 إلى 1.
- tintsarray<string>
  درجاته الأفتح، بصيغة #RRGGBB.
fontsarray<object>
خطوط الهوية.
- familystring
  اسم الخط.
- scriptstring | null
  الكتابة التي يغطيها: عربية أو لاتينية أو الاثنتان.
  arabiclatinboth
- rolestring | null
  دوره في الهوية.
  primarysecondarydisplaybodyother
- urlstring | null
  رابط صفحته، إن وُجد.
currentVersionobject | null
النسخة المعتمدة اليوم، أو أحدث نسخة منشورة إن لم تُنشر الحالية بعد.
- slugstring
  معرّف النسخة النصي.
- title{ ar: string | null, en: string | null }
  عنوان النسخة، إن كان لها عنوان.
- releaseDatestring | null
  تاريخ الإصدار YYYY-MM-DD؛ دقته في releasePrecision.
- releasePrecisionstring | null
  دقة التاريخ: يوم أو شهر أو سنة. مع year اعرض السنة فقط.
  daymonthyearunknown
- identityStatusstring | null
  latest للهوية الأحدث وprevious لهوية سابقة.
  latestprevious
- logoobject | null
  ملف الشعار الأساسي للنسخة.
  idstring
  معرّف الملف، لـ /dl/:id و/api/v1/assets/:id/thumb.
  kindstring
  نوع الملف.
  svgpngjpgwebpgifpdfaiepspsdzipfontothermp4movwebm
  mimestring
  نوع المحتوى.
  widthinteger | null
  العرض بالبكسل؛ null للملفات المتجهة بلا أبعاد.
  heightinteger | null
  الارتفاع بالبكسل.
  byteSizeinteger
  الحجم بالبايت.
  pageCountinteger | null
  عدد الصفحات لملف PDF.
  urlstring | null
  رابط الملف الأصلي على خادم الملفات. لا يُحسب تحميلًا. null في العرض التجريبي بلا مفتاح.
  downloadUrlstring | null
  الملف الأصلي على دومين الملفات. null في العرض التجريبي بلا مفتاح.
  png1024Urlstring | null
  نسخة PNG بضلع 1024 على دومين الملفات، أو null إن لم تُصنع.
  thumbnailUrlstring | null
  صورة مصغرة WebP بضلع 256 على خادم الملفات.
- variantsarray<object>
  ملفات النسخة الأخرى: الرمز، والكتابة، والأحادي، والداكن…
  rolestring
  دور الملف.
  primarysymbolwordmarkarabicenglishbilingualhorizontalverticalmonochromedarklightthumbnailalternateother
  colorModestring | null
  ألوانه: ملون، أو أحادي، أو dark مصمم للخلفيات الداكنة، أو light للفاتحة.
  colormonodarklightunknown
  languagestring | null
  لغة الكتابة فيه.
  arenbilingualnoneunknown
  orientationstring | null
  اتجاهه: أفقي أو عمودي أو مربع.
  horizontalverticalsquareunknown
  formstring | null
  ما يعرضه: الشعار كاملًا، أو الرمز، أو الكتابة، أو الشعار مع عبارة.
  fullsymbolwordmarktaglineunknown
  label{ ar: string, en: string | null }
  اسم الملف كما تسميه صفحة العلامة.
  assetobject | null
  الملف.
  idstring
  معرّف الملف، لـ /dl/:id و/api/v1/assets/:id/thumb.
  kindstring
  نوع الملف.
  svgpngjpgwebpgifpdfaiepspsdzipfontothermp4movwebm
  mimestring
  نوع المحتوى.
  widthinteger | null
  العرض بالبكسل؛ null للملفات المتجهة بلا أبعاد.
  heightinteger | null
  الارتفاع بالبكسل.
  byteSizeinteger
  الحجم بالبايت.
  pageCountinteger | null
  عدد الصفحات لملف PDF.
  urlstring | null
  رابط الملف الأصلي على خادم الملفات. لا يُحسب تحميلًا. null في العرض التجريبي بلا مفتاح.
  downloadUrlstring | null
  الملف الأصلي على دومين الملفات. null في العرض التجريبي بلا مفتاح.
  png1024Urlstring | null
  نسخة PNG بضلع 1024 على دومين الملفات، أو null إن لم تُصنع.
  thumbnailUrlstring | null
  صورة مصغرة WebP بضلع 256 على خادم الملفات.
versionsarray<object>
كل النسخ المنشورة، الحالية أولًا ثم الأحدث فالأقدم.
- slugstring
  معرّف النسخة النصي.
- versionNointeger
  رقم النسخة.
- isCurrentboolean
  true للنسخة الحالية.
- identityStatusstring | null
  latest للهوية الأحدث وprevious لهوية سابقة.
  latestprevious
- title{ ar: string | null, en: string | null }
  عنوان النسخة، إن كان لها عنوان.
- releaseDatestring | null
  تاريخ الإصدار YYYY-MM-DD؛ دقته في releasePrecision.
- releasePrecisionstring | null
  دقة التاريخ: يوم أو شهر أو سنة. مع year اعرض السنة فقط.
  daymonthyearunknown
- logoobject | null
  ملف الشعار الأساسي للنسخة.
  idstring
  معرّف الملف، لـ /dl/:id و/api/v1/assets/:id/thumb.
  kindstring
  نوع الملف.
  svgpngjpgwebpgifpdfaiepspsdzipfontothermp4movwebm
  mimestring
  نوع المحتوى.
  widthinteger | null
  العرض بالبكسل؛ null للملفات المتجهة بلا أبعاد.
  heightinteger | null
  الارتفاع بالبكسل.
  byteSizeinteger
  الحجم بالبايت.
  pageCountinteger | null
  عدد الصفحات لملف PDF.
  urlstring | null
  رابط الملف الأصلي على خادم الملفات. لا يُحسب تحميلًا. null في العرض التجريبي بلا مفتاح.
  downloadUrlstring | null
  الملف الأصلي على دومين الملفات. null في العرض التجريبي بلا مفتاح.
  png1024Urlstring | null
  نسخة PNG بضلع 1024 على دومين الملفات، أو null إن لم تُصنع.
  thumbnailUrlstring | null
  صورة مصغرة WebP بضلع 256 على خادم الملفات.
- urlstring
  صفحة النسخة في الأرشيف.
guidelinesarray<object>
أدلة الهوية المنشورة.
- title{ ar: string | null, en: string | null }
  عنوان الدليل.
- typestring | null
  نوعه: دليل هوية، أو استخدام الشعار، أو الخطوط.
  brand_guidelineslogo_usagetypographyother
- officialboolean
  true حين يكون من الجهة نفسها.
- assetobject | null
  ملف الدليل، PDF غالبًا.
  idstring
  معرّف الملف، لـ /dl/:id و/api/v1/assets/:id/thumb.
  kindstring
  نوع الملف.
  svgpngjpgwebpgifpdfaiepspsdzipfontothermp4movwebm
  mimestring
  نوع المحتوى.
  widthinteger | null
  العرض بالبكسل؛ null للملفات المتجهة بلا أبعاد.
  heightinteger | null
  الارتفاع بالبكسل.
  byteSizeinteger
  الحجم بالبايت.
  pageCountinteger | null
  عدد الصفحات لملف PDF.
  urlstring | null
  رابط الملف الأصلي على خادم الملفات. لا يُحسب تحميلًا. null في العرض التجريبي بلا مفتاح.
  downloadUrlstring | null
  الملف الأصلي على دومين الملفات. null في العرض التجريبي بلا مفتاح.
  png1024Urlstring | null
  نسخة PNG بضلع 1024 على دومين الملفات، أو null إن لم تُصنع.
  thumbnailUrlstring | null
  صورة مصغرة WebP بضلع 256 على خادم الملفات.
relatedarray<object>
علامات ذات صلة: الأم، والتابعة، والشقيقة، والاسم السابق…
- typestring
  نوع الصلة كما سُجّلت من هذه العلامة.
  parentsubsidiarysisterprevious_namesuccessorecosystemrelated
- slugstring
  المعرّف النصي للعلامة الأخرى.
- name{ ar: string, en: string | null }
  اسمها.
collectionsarray<string>
معرّفات المجموعات العامة التي تضمها.
statsobject
أرقام الأرشيف عنها.
- downloadsTotalinteger
  كل التحميلات.
- downloads30dinteger
  تحميلات آخر 30 يومًا.
- viewsTotalinteger
  كل زيارات صفحتها.
updatedAtstring
آخر تعديل، بتوقيت ISO.
urlstring
صفحتها في الأرشيف.
accessstring
demo حين يُرجع السجل بلا مفتاح لصفحات الموقع نفسها: بلا روابط الملفات الأصلية. غائب في السجل الكامل.
demo

رموز الحالة

200
نجح الطلب.
308
العلامة غيّرت عنوانها؛ Location فيه العنوان الجديد، والمتصفح وأغلب المكتبات تتبعه.
400
المفتاح في الرابط مرفوض. أرسله في ترويسة Authorization.
{"error":"key_in_url"}
401
لا مفتاح في الطلب، والمفتاح مطلوب.
{"error":"api_key_required"}
401
المفتاح غير صحيح أو أُلغي.
{"error":"invalid_api_key"}
403
حساب المطور موقوف.
{"error":"account_suspended"}
402
انتهت سحوبات الشهر في باقتك، أو بلغت سقف الإنفاق الذي حددته. ترويسة X-Quota-Reset تقول متى يتجدد الحد.
{"error":"quota_exceeded"}
404
لا توجد علامة منشورة بهذا المعرّف.
{"error":"not_found"}
429
تجاوزت الحد. انتظر عدد الثواني في Retry-After ثم أعد المحاولة.
{"error":"rate_limited"}

مثال

curl -sS 'https://new.wasmenia.com/api/v1/brands/stc' \  -H "Authorization: Bearer $WASMENIA_API_KEY"

املأ المطلوب ثم أرسل الطلب. الطلب حقيقي، على الأرشيف المنشور.

المعاملات

الاستجابة

رموز الحالة

مثال

جرّبها