گزارش سفرها (Ride History)

این گزارش لیستی از سفرها را ارائه می‌دهد و امکان جست‌وجو با فیلترهای مختلف از جمله زمان سفر، کد سفر، نام مسافر و شماره تماس مسافر را فراهم می‌کند.

---

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

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

---

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

نام پارامتر	نوع	توضیحات
page	integer	شماره صفحه
limit	integer	تعداد آیتم‌ها در هر صفحه
credit	integer	نوع اعتبار
date_min	string	حداقل تاریخ فیلتر شده (اختیاری)
date_max	string	حداکثر تاریخ فیلتر شده (اختیاری)
hri	string	شناسه خوانایی سفر (اختیاری)
mobile	string	شماره موبایل مسافر (اختیاری)
name	string	نام مسافر (اختیاری)

---

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

curl -X GET "https://corporate.snapp.site/api/v2/ride/history?page=1&limit=50" \
  -H "Authorization: <your_authorization_token>" \
  -H "Accept: application/json"

---

پاسخ موفق

{
    "message": "",
    "data": {
        "rides": [
            {
                "ride_price": 490000,
                "donation_amount": 0,
                "public_id": "string",
                "human_readable_id": "string",
                "corporate_passenger_name": "string",
                "corporate_passenger_mobile": "string",
                "corporate_passenger_email": "string",
                "service_type_name": "string",
                "title": "string",
                "origin": {
                    "formatted_address": "string"
                },
                "destination": {
                    "formatted_address": "string"
                },
                "accepted_driver": {
                    "cellphone": "string",
                    "first_name": "string",
                    "last_name": "string"
                },
                "final_price": 490000,
                "receipt_link": "string",
                "date": "string"
            }
        ]
    },
    "status": 200
}

---

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

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