مرجع API · البطاقات المملوكة

قائمة البطاقات المملوكة

GET/v1/wallets/{walletId}/cards

البطاقات التي اشترتها محفظة، ورموزها مخفية. مقسّمة إلى صفحات بمؤشر.

الصلاحيةcards:read

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

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

حزمة SDK لـ ‎.NETanis.OwnedCards.ListAsync(walletId)

المعاملات

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

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

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

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

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

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

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

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف البطاقة المبيعة — وهو ما يأخذه كشف بطاقة واحدة.
`orderOperationId`	UUID	معرّف عملية طلب الشراء الذي اشتراها.
`invoiceId`	any	الفاتورة التي عليها — وهو ما يأخذه كشف فاتورة كاملة.
`card`	object	بطاقة الكتالوج التي بيعت منها.
`card.id`	UUID	معرّف بطاقة الكتالوج.
`card.name`	LocalizedText	اسم بطاقة الكتالوج، بالعربية والإنجليزية.
`serialNumberMasked`	string	الرقم التسلسلي مخفيًا جزئيًا. الرموز الكاملة لا تأتي إلا من الكشف.
`credentialAvailable`موجود دائمًا	boolean	هل يمكن كشف رموز هذه البطاقة.
`purchasedAt`	string (date-time)	وقت شرائها.

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