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

قائمة المحافظ

GET/v1/wallets

المحافظ المسموح لتطبيقك باستخدامها، وأرصدتها. مقسّمة إلى صفحات بمؤشر (cursor).

الصلاحيةwallets:read

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

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

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

المعاملات

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

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

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

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

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

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

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

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

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