گزارش مالی (Financial History)

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

---

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

• آدرس: /api/v3/financial/history
• متد: POST
• نوع خروجی: application/json
• احراز هویت: نیازمند token

---

پارامترهای بدنه درخواست (Body)

نام پارامتر	نوع	توضیحات
page	integer	شماره صفحه
date_min	integer	حداقل تاریخ فیلتر شده (timestamp)
date_max	integer	حداکثر تاریخ فیلتر شده (timestamp)

---

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

curl -X POST "https://corporate.snapp.site/api/v3/financial/history" \
  -H "Authorization: <your_authorization_token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --data-raw '{"page":1,"date_max":1740515400,"date_min":1739910600}'

---

پاسخ موفق

{
    "status": 200,
    "data": {
        "transactions": [
            {
                "transaction_type": 55,
                "transaction_reference": "string",
                "creditor": 3500000,
                "debtor": 0,
                "description": "string",
                "current_balance": 0,
                "created_at": "string",
                "date_time": "string"
            }
        ]
    }
}

---

کدهای وضعیت و خطاها

کد وضعیت	توضیحات
200	درخواست با موفقیت انجام شد
400	درخواست نامعتبر است (مثلاً پارامترهای نامعتبر ارسال شده‌اند)
401	عدم احراز هویت (توکن JWT نامعتبر یا منقضی‌شده است)
403	دسترسی غیرمجاز
500	خطای داخلی سرور