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

قائمة فئات الكتالوج

GET/v1/wallets/{walletId}/catalog/categories

المستوى الأعلى من الكتالوج كما تراه هذه المحفظة. مقسّمة إلى صفحات بمؤشر.

الصلاحيةcatalogue:read

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

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

حزمة SDK لـ ‎.NETanis.Catalogue.ListCategoriesAsync(walletId)

المعاملات

الاسم	الموضع	النوع	ملاحظات
`walletId`إلزامي	`path`	UUID	معرّف UUID بأحرف صغيرة مع الشرطات.
`cursor`اختياري	`query`	string	قيمة `nextCursor` من الصفحة السابقة، تُعاد كما استُلمت بالضبط. اتركها للصفحة الأولى.

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

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

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

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

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

الحقل	النوع	ملاحظات
`items`موجود دائمًا	list of CatalogueObject	الفئات أو الفئات الفرعية أو البطاقات في هذه الصفحة — كل مسار قائمة يُرجع نوعًا واحدًا.
`nextCursor`	string	مرّره في `cursor` للحصول على الصفحة التالية. غير موجود في الصفحة الأخيرة.

واحد من: 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)	وقت قراءة هذا السعر أو الرصيد.