گزارش بودجه کارمندان (Budget Restriction)

این گزارش اطلاعاتی درباره بودجه کارمندان در هر پنل سازمانی ارائه می‌دهد، از جمله میزان بودجه باقی‌مانده هر کاربر. همچنین امکان جست‌وجو بر اساس نام و شماره موبایل کارمند نیز وجود دارد.

---

اطلاعات عمومی

• آدرس:

  /api/v2/wallet-restriction/budget-restriction/list

• متد: GET

• نوع محتوا: application/json

• احراز هویت: نیازمند توکن

---

احراز هویت

• این درخواست نیاز به ارسال توکن در هدر Authorization دارد.

---

پارامترهای کوئری

پارامتر	نوع داده	ضروری	توضیحات
name	string	خیر	نام مسافر
cellphone	string	خیر	شماره تلفن همراه مسافر

---

هدرهای درخواست

هدر	مقدار	توضیحات
Authorization	token	توکن احراز هویت کاربر
Accept	application/json	نوع داده خروجی

---

نمونه درخواست

curl --location --request GET '<base_url>/api/v2/wallet-restriction/budget-restriction/list?name=John&cellphone=09123456789' \
--header 'Authorization: <your_authorization_token>' \
--header 'Accept: application/json'

---

پاسخ موفق

{
  "message": "User budget restrictions retrieved successfully",
  "status": 200,
  "data": [
    {
      "restriction_id": 1,
      "passenger_id": 12345,
      "amount": 500000,
      "name": "John Doe",
      "cellphone": "09123456789",
      "type": 2
    },
    {
      "restriction_id": 2,
      "passenger_id": 67890,
      "amount": 300000,
      "name": "Jane Smith",
      "cellphone": "09234567890",
      "type": 1
    }
  ]
}

---

توضیحات فیلدهای پاسخ

فیلد	نوع داده	توضیحات
message	string	پیام موفقیت‌آمیز دریافت داده‌ها
status	integer	وضعیت پاسخ
data	array	لیست مسافرانی که محدودیت بودجه دارند
restriction_id	int64	شناسه محدودیت بودجه
passenger_id	int64	شناسه مسافر
amount	int64	مبلغ محدودیت بودجه (ریال)
name	string	نام مسافر
cellphone	string	شماره تلفن همراه مسافر
type	int	نوع محدودیت بودجه

---

خطاها

کد وضعیت	توضیحات
400	درخواست نامعتبر
401	نیاز به احراز هویت
403	دسترسی غیرمجاز
500	خطای داخلی سرور

---

توضیحات تکمیلی

• اگر مقدار name یا cellphone ارسال نشود، تمام کاربران دارای محدودیت بودجه برگردانده می‌شوند.
• type نشان‌دهنده نوع محدودیت بودجه است.