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

قراءة بطاقة مملوكة

GET/v1/wallets/{walletId}/cards/{soldCardId}

بطاقة مشتراة واحدة، ورموزها مخفية.

الصلاحيةcards:read

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

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

حزمة SDK لـ ‎.NETanis.OwnedCards.GetAsync(walletId, soldCardId)

المعاملات

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

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

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

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

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

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

الحقل	النوع	ملاحظات
`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	النص الإنجليزي.