دریافت قیمت سفر بعد از بروزرسانی گزینه های سفر (Get Upate Price)

برای دریافت قیمت سفر بعد از بروزرسانی گزینه های سفر استفاده می‌شود.

---

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

• آدرس:

  <base_url>/api/v1/ride/{hri}/update/price

• متد: POST

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

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

---

احراز هویت

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

---

پارامترهای مسیر

پارامتر	نوع داده	ضروری	توضیحات
hri	string	بله	شناسه‌ی منحصربه‌فرد سفر

---

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

هدر	مقدار	توضیحات
Authorization	Bearer <token>	توکن احراز هویت کاربر
Content-Type	application/json	نوع محتوا

---

بدنه درخواست

فیلد	نوع داده	ضروری	توضیحات
extra_destination_lat	float	خیر	عرض جغرافیایی مقصد اضافی
extra_destination_lng	float	خیر	طول جغرافیایی مقصد اضافی
round_trip	boolean	خیر	مشخص می‌کند که سفر رفت و برگشت است یا خیر
waiting	integer	خیر	مدت‌زمان انتظار (برحسب دقیقه)
by_credit	boolean	خیر	پرداخت از طریق اعتبار

---

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

curl --location --request POST '<base_url>/api/v1/ride/ABC123/update/price' \
--header 'Authorization: Bearer your_token_here' \
--header 'Content-Type: application/json' \
--data-raw '{
    "extra_destination_lat": 35.790845919867,
    "extra_destination_lng": 52.403267927447,
    "round_trip": false,
    "waiting": null,
    "by_credit": false
}'

---

پاسخ موفق

{
  "message": "Ride options updated successfully",
  "status": 200,
  "data": {
    "extra_destination_lat": 35.790845919867,
    "extra_destination_lng": 52.403267927447,
    "round_trip": false,
    "waiting": null,
    "by_credit": false,
    "updated_price": 120000
  }
}

---

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

فیلد	نوع داده	توضیحات
message	string	پیام موفقیت‌آمیز بروزرسانی
status	integer	وضعیت پاسخ
data	object	اطلاعات بروزرسانی‌شده سفر
data.updated_price	integer	قیمت جدید سفر بعد از بروزرسانی

---

خطاها

کد وضعیت	توضیحات
400	درخواست نامعتبر (ورودی‌های اشتباه)
401	نیاز به احراز هویت
403	دسترسی غیرمجاز
404	سفر موردنظر یافت نشد
500	خطای داخلی سرور

---

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

• باید پس از تأیید قیمت جدید، این API را با بادی یکسان فراخوانی کنید:
• POST /api/v1/ride/{hri}/update/ride
• مقدار waiting می‌تواند null باشد اگر گزینه‌ی انتظار فعال نشود.
• اگر گزینه‌ی round_trip true باشد، سیستم هزینه‌ی برگشت را محاسبه خواهد کرد.