مرجع API · طلبات الشراء

قراءة طلب شراء

GET/v1/orders/{operationId}

أين وصل طلب الشراء. يعرض الحالة فقط: لا يحمل رموز البطاقات أبدًا ولا يدفع الطلب إلى الأمام — لاستئناف طلب شراء أرسله مجددًا.

الصلاحيةorders:read

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

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

حزمة SDK لـ ‎.NETanis.Orders.GetAsync(operationId)

المعاملات

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

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

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

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

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

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

الحقل	النوع	ملاحظات
`operationId`موجود دائمًا	UUID	معرّف العملية الذي اخترته وأرسلته في `Idempotency-Key`.
`status`موجود دائمًا	string	`processing`: قُبل ولا نتيجة بعد. `completed`: تمّ الشراء. `failed`: رفضته قاعدة عمل، ولم يُشترَ شيء. `recoveryExhausted`: لم تتمكن أنيس بعد من معرفة النتيجة — ربما اكتمل؛ واصل الاستئناف ببطء وأبلغ أنيس. القيم: `processing`, `recoveryExhausted`, `completed`, `failed`
`invoiceId`	UUID	الفاتورة التي عليها البطاقات. استخدمه لكشفها مجددًا لاحقًا.
`walletId`	UUID	المحفظة التي دُفع منها طلب الشراء.
`cardId`	UUID	بطاقة الكتالوج التي اشتُريت.
`quantity`	integer	عدد البطاقات.
`total`	Money	تكلفة طلب الشراء.
`soldCards`	list of RevealedCredential	رموز البطاقات. موجودة فقط في الرد الذي يعلن اكتمال طلب الشراء أول مرة — احفظها قبل أي شيء آخر.
`completedAt`	string (date-time)	وقت اكتمال طلب الشراء.

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

الحقل	النوع	ملاحظات
`soldCardId`موجود دائمًا	UUID	البطاقة المبيعة التي تخصها هذه الرموز.
`serialNumber`	string	الرقم التسلسلي للبطاقة. سرّ: احفظه حيث تحفظ الأسرار ولا تسجّله في السجلات أبدًا.
`voucher`	string	رمز القسيمة للبطاقة. سرّ: احفظه حيث تحفظ الأسرار ولا تسجّله في السجلات أبدًا.
`revealedAt`	string (date-time)	وقت كشفها.