الحساب

البادئة: /v1/account. المصادقة: عميل على كل مسار (Authorization: Bearer).

استدعِ GET /v1/account/me بعد الدخول لتعبئة الملف. المبالغ بالفلس؛ النقاط أعداد صحيحة.

الملف الشخصي

الطريقة	المسار	الجسم / ملاحظات
GET	/v1/account/me	سجل العميل العام
PATCH	/v1/account/profile	اختياري: name، email، language (en|ar)، dateOfBirth، gender، householdSize

المحفظة والولاء

الطريقة	المسار	الغرض
GET	/v1/account/wallet	حركات المحفظة (صفحات)
GET	/v1/account/loyalty	حركات النقاط (صفحات)

تظهر الأرصدة أيضاً في GET /v1/account/me / GET /v1/init. المبالغ بالفلس؛ النقاط أعداد صحيحة.

العناوين

الطريقة	المسار	الجسم
GET	/v1/account/addresses	—
POST	/v1/account/addresses	إنشاء
PATCH	/v1/account/addresses/:addressId	تحديث جزئي
DELETE	/v1/account/addresses/:addressId	حذف

جسم الإنشاء (مطلوب)

الحقل	ملاحظات
label	مثل المنزل
lat، lng	دبوس الخريطة
city	اسم المنطقة من الترميز العكسي

اختياري: governorateNo، areaId، block، street، building، floor، apartment، phone، notes، isDefault.

المفضلة

الطريقة	المسار	الجسم
GET	/v1/account/wishlist	productIds + products بصفحات
POST	/v1/account/wishlist	{ productId }
DELETE	/v1/account/wishlist/:productId	—

كتابة المفضلة تُحظر في وضع صيانة المتجر.

المشاهدات الأخيرة

الطريقة	المسار	الجسم
GET	/v1/account/viewed	قائمة
POST	/v1/account/viewed	تتبع منتج واحد
POST	/v1/account/viewed/merge	دمج قائمة الضيف بعد الدخول

اشتراك برو

الطريقة	المسار	الجسم
GET	/v1/subscription-plans	الخطط العامة (بلا بادئة حساب)
GET	/v1/account/subscription	الاشتراك الحالي أو null
POST	/v1/account/subscription	{ planId }
POST	/v1/account/subscription/cancel	إلغاء عند نهاية الفترة

الحالات: active، expired، cancelled. cancelAtPeriodEnd صحيح عند الإلغاء والفترة ما تزال سارية.