مرجع API · المحافظ

قراءة محفظة

GET/v1/wallets/{walletId}

محفظة واحدة ورصيدها.

الصلاحيةwallets:read

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

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

حزمة SDK لـ ‎.NETanis.Wallets.GetAsync(walletId)

المعاملات

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

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

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

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

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

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

الحقل	النوع	ملاحظات
`id`موجود دائمًا	UUID	معرّف المحفظة. كل استدعاء على مستوى المحفظة يأخذه في العنوان.
`name`موجود دائمًا	string	اسم المحفظة.
`currency`موجود دائمًا	string	العملة التي تحملها المحفظة وتشتري بها.
`balance`موجود دائمًا	Money	الرصيد الذي يمكنك إنفاقه الآن، مع وقت قراءته.

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