قائمة الجهات

GET/api/v1/brands

قائمة العلامات المنشورة بالفلاتر نفسها التي تستخدمها صفحة «الشعارات»، صفحة بعد صفحة. لكل علامة بطاقتها المختصرة؛ اقرأ سجلها الكامل من /api/v1/brands/:slug.

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

المعاملات

q
stringفي الاستعلاماختياري
بحث بالاسم داخل القائمة. يرتّب النتائج بالأقرب، ويعيد أفضل 100 فقط.
حتى 120 · الأطول يُقص
country
listفي الاستعلاماختياري
رمز الدولة من حرفين، أو عدة رموز مفصولة بفاصلة: SA,AE.
القيمة غير الصالحة تُتجاهل
category
listفي الاستعلاماختياري
معرّف القطاع النصي؛ يشمل القطاعات المتفرعة منه.
حتى 80 · القيمة غير الصالحة تُتجاهل
industry
listفي الاستعلاماختياري
معرّف الصناعة النصي.
حتى 80 · القيمة غير الصالحة تُتجاهل
entityType
listفي الاستعلاماختياري
نوع الجهة، واحد أو أكثر.
القيمة غير الصالحة تُتجاهل
governmentsemi_governmentprivate_companynonprofituniversitysportseventcampaignproductmediaprogramother
sector
stringفي الاستعلاماختياري
government للجهات الحكومية وشبه الحكومية، وprivate لكل ما سواها.
القيمة غير الصالحة تُتجاهل
governmentprivate
version
stringفي الاستعلاماختياري
current للعلامات التي لها نسخة حالية، وhistorical لمن لها نسخ سابقة.
الافتراضي: all · القيمة غير الصالحة تُتجاهل
currenthistoricalall
year
integerفي الاستعلاماختياري
سنة إصدار نسخة من نسخ العلامة.
1900–2100 · القيمة غير الصالحة تُتجاهل
yearFrom
integerفي الاستعلاماختياري
أقدم سنة إصدار.
1900–2100 · القيمة غير الصالحة تُتجاهل
yearTo
integerفي الاستعلاماختياري
أحدث سنة إصدار.
1900–2100 · القيمة غير الصالحة تُتجاهل
has
listفي الاستعلاماختياري
ما يجب أن يتوفر للعلامة: ملف svg أو png أو pdf، أو دليل هوية guidelines.
القيمة غير الصالحة تُتجاهل
svgpngpdfguidelines
verified
booleanفي الاستعلاماختياري
1 للجهات الموثّقة فقط.
القيمة غير الصالحة تُتجاهل
collection
stringفي الاستعلاماختياري
معرّف مجموعة عامة منشورة من مجموعات الأرشيف.
حتى 80 · القيمة غير الصالحة تُتجاهل
sort
stringفي الاستعلاماختياري
ترتيب النتائج. مع q يرتّب relevance وnewest بالأقرب.
الافتراضي: newest · القيمة غير الصالحة تُتجاهل
relevancenewestupdateddownloadsalpha_aralpha_en
page
integerفي الاستعلاماختياري
رقم الصفحة، من 1 إلى 500.
الافتراضي: 1 · 1–500 · خارج الحدود يُحصر بها
limit
integerفي الاستعلاماختياري
عدد العلامات في الصفحة، حتى 50.
الافتراضي: 24 · 1–50 · خارج الحدود يُحصر بها

الاستجابة

totalinteger
عدد كل العلامات المطابقة.
pageinteger
رقم هذه الصفحة.
pageCountinteger
عدد الصفحات؛ 0 حين لا يطابق شيء.
itemsarray<object>
بطاقات العلامات في هذه الصفحة.
- slugstring
  المعرّف النصي، وهو عنوان صفحتها: /brands/:slug.
- name{ ar: string, en: string | null }
  الاسم باللغتين. en قد يكون null.
- countrystring | null
  رمز الدولة من حرفين.
- categorystring | null
  المعرّف النصي للقطاع.
- verifiedboolean
  true حين تكون الجهة موثّقة رسميًا.
- versionsinteger
  عدد النسخ المنشورة.
- thumbnailUrlstring | null
  صورة الشعار المصغرة WebP.
- urlstring
  صفحتها في الأرشيف.

رموز الحالة

200
نجح الطلب.
400
المفتاح في الرابط مرفوض. أرسله في ترويسة Authorization.
{"error":"key_in_url"}
401
لا مفتاح في الطلب، والمفتاح مطلوب.
{"error":"api_key_required"}
401
المفتاح غير صحيح أو أُلغي.
{"error":"invalid_api_key"}
403
حساب المطور موقوف.
{"error":"account_suspended"}
429
تجاوزت الحد. انتظر عدد الثواني في Retry-After ثم أعد المحاولة.
{"error":"rate_limited"}

مثال

curl -sS -G 'https://new.wasmenia.com/api/v1/brands' \  -H "Authorization: Bearer $WASMENIA_API_KEY" \  --data-urlencode 'country=SA' \  --data-urlencode 'limit=12'

جرّبها

qcountrycategoryindustryentityTypesectorversionyearyearFromyearTohasverifiedcollectionsortpagelimit

GET /api/v1/brands?country=SA&limit=12

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