لیست سفرهای فعال (Active Ride)

لیستی از سفرهای فعال را نمایش می‌دهد.

---

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

• آدرس: /api/v2/ride/active?page={page_number}
• متد: GET
• نوع محتوا: application/json
• احراز هویت: نیازمند token

---

احراز هویت

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

---

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

درخواست باید شامل پارامتر زیر در URL باشد:

فیلد	نوع داده	ضروری	توضیحات
page	number	خیر	شماره صفحه برای دریافت نتایج سفرها

---

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

curl --location 'https://corporate.snapp.site/api/v2/ride/active?page=1' \
--header 'Authorization: <your_authorization_token>'

---

پاسخ موفق

{
  "active_rides": [
    {
      "waitings": [
        {
          "key": "0m-5m",
          "price": 30000,
          "text": "۰ تا ۵ دقیقه"
        }
      ],
      "ride_info": {
        "ride_id": "SNP-250223-02506-0982",
        "current_state": 1,
        "name": "تست",
        "cellphone": "+989121292382",
        "service_type": 1,
        "is_delivery": false,
        "sub_service_type": null,
        "final_price": 170000,
        "can_use_ride_voucher": true,
        "start_time": "14:51",
        "shareurl": "https://share-look-snapp-ode-008.apps.private.okd4.teh-1.snappcloud.io/passenger/MnqOd9R2ANMvly0V4Wjv",
        "payment_type": 0,
        "origin": {
          "lat": 35.77764371308767,
          "lng": 51.45786528970834,
          "formatted_address": "تهران، دروس، محمد صالح حسینی، حمید چیذری تقاطع پروانه",
          "details": ""
        },
        "destination": {
          "lat": 35.693760422521066,
          "lng": 51.46110716693616,
          "formatted_address": "تهران، زاهد گیلانی، پیروزی، باقری، انصاری قبل از بهار",
          "details": ""
        },
        "is_chat_enable": false,
        "is_routing_enable": null
      },
      "service_type": {
        "name": "اسنپ",
        "type": "1",
        "tooltip": "",
        "photo_url": "https://web-cdn.snapp.ir/pricing/service-types/Yalda2024/Eco.png",
        "description": "به صرفه",
        "long_description": "",
        "is_new": false,
        "can_use_voucher": true,
        "is_ride_options_enabled": true,
        "need_additional_information": false,
        "can_change_regular_offer_state": false,
        "is_surged": false,
        "surge": null
      },
      "options": null,
      "tips": [],
      "friend_info": {
        "is_for_friend": false,
        "name": "تست",
        "cellphone": "+989111002233"
      }
    }
  ]
}

فیلد	نوع داده	توضیحات
waitings	array	آرایه‌ای از گزینه‌های زمان انتظار با قیمت‌ها
ride_info	object	اطلاعات سفر فعال
service_type	object	اطلاعات نوع خدمات (مثل نوع تاکسی یا سرویس)
options	object	اطلاعات اضافی سفر (در این مثال null است)
tips	array	لیست انعام‌ها
friend_info	object	اطلاعات دوست که سفر برای او انجام می‌شود (در این مثال false است)

---

خطاها

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

---

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

• داده‌های مربوط به waitings شامل قیمت‌های مربوط به زمان انتظار هستند که در حالت‌های مختلف ارائه می‌شوند.
• ride_info شامل اطلاعات مهمی همچون شناسه سفر، زمان شروع، آدرس مبدأ و مقصد، قیمت نهایی و غیره می‌باشد.
• service_type نوع و ویژگی‌های سرویس (مثل نوع خودرو) را نشان می‌دهد.