مرجع API · الكتالوج

قراءة فئة فرعية

GET/v1/wallets/{walletId}/catalog/subcategories/{subcategoryId}

فئة فرعية واحدة.

الصلاحيةcatalogue:read

المصادقةقراءة موقَّعة

حدود الموظفين التي يُحتسب ضمنهاكل الاستدعاءات

حزمة SDK لـ ‎.NETanis.Catalogue.GetSubcategoryAsync(walletId, subcategoryId)

المعاملات

الاسم	الموضع	النوع	ملاحظات
`walletId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.
`subcategoryId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.

موقَّعة بمفتاحك. بلا محتوى وبلا رقم استخدام لمرة واحدة (nonce).

الترويسات: Signature-Input، Signature، X-Anis-Date، Accept-Language (اختياري). تضبطها حزم SDK كلها نيابةً عنك.

المحتوى: لا يوجد.

كل ردّ موقَّع من أنيس؛ وتتحقق منه حزم SDK قبل أن يصلك.

كل رفض مشكلةٌ موقَّعة. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.

واحد من: CatalogueCategory, CatalogueSubcategory, CatalogueCard — كل مسار يُرجع نوعًا واحدًا منها بالضبط.

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف الفئة.
`name`	LocalizedText	اسم الفئة، بالعربية والإنجليزية.
`description`	LocalizedText	وصف، بالعربية والإنجليزية.
`logo`	string	عنوان صورة شعار الفئة.
`type`	string	هل الفئة محلية أم دولية. القيم: `local`, `international`
`inStock`موجود دائمًا	boolean	هل يمكن شراء أي شيء فيها الآن.
`displayOrder`موجود دائمًا	integer	ترتيب عرض الفئات — الأصغر أولًا.

الحقل	النوع	ملاحظات
`ar`	string	النص العربي.
`en`	string	النص الإنجليزي.

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف الفئة الفرعية.
`categoryId`موجود دائمًا	UUID	الفئة التي تتبع لها.
`name`	LocalizedText	اسم الفئة الفرعية، بالعربية والإنجليزية.
`description`	LocalizedText	وصف، بالعربية والإنجليزية.
`logo`	string	عنوان صورة شعار الفئة الفرعية.
`isBestSelling`موجود دائمًا	boolean	علّمتها أنيس بأنها من الأكثر مبيعًا.
`displayOrder`موجود دائمًا	integer	ترتيب عرض الفئات الفرعية — الأصغر أولًا.
`available`موجود دائمًا	boolean	هل يمكن الشراء منها الآن.

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف البطاقة — وهو `cardId` الذي يحمله طلب الشراء.
`subcategoryId`موجود دائمًا	UUID	الفئة الفرعية التي تتبع لها.
`name`	LocalizedText	اسم البطاقة، بالعربية والإنجليزية.
`faceValue`	string	القيمة المطبوعة على البطاقة، إن وُجدت.
`unitPrice`	Money	السعر الذي تدفعه هذه المحفظة. أرسله دون تغيير في `expectedUnitPrice` لطلب الشراء. البطاقة التي لا تملكه لا يمكن بيعها لهذه المحفظة.
`businessPrice`	Money	للعرض فقط. طلب الشراء بهذا السعر قد يُرفض بـ `price_changed`.
`personalPrice`	Money	سعر التجزئة، ويُعرض فقط ما دام أعلى من سعر الأعمال. للعرض فقط.
`hasSpecialOffer`موجود دائمًا	boolean	هل يوجد عرض خاص.
`specialOfferPrice`	Money	سعر العرض، ويُعرض فقط مع العرض الخاص. للعرض فقط.
`available`موجود دائمًا	boolean	هل يمكن شراء البطاقة الآن.

الحقل	النوع	ملاحظات
`amount`موجود دائمًا	string	نصّ عشري بثلاث خانات عشرية بالضبط، مثل `"10.500"` — وليس رقم JSON أبدًا.
`currency`موجود دائمًا	string	رمز العملة، مثل `LYD`: وهو دائمًا عملة المحفظة.
`asOf`	string (date-time)	وقت قراءة هذا السعر أو الرصيد.