RESOURCE /b2c/v1/travel_requests

Travel Requests API

مجموعه اندپوینت‌های /b2c/v1/travel_requests برای ثبت، مشاهده، و مدیریت درخواست‌های سفر طراحی شده است. این مجموعه از ساختار Route::resource لاراول استفاده می‌کند و زیر مجموعه‌ای از کنترلر TravelRequestsController می‌باشد. تمام مسیرها از طریق middleware: authWithJwt محافظت می‌شوند.

Endpoints Overview

۱. لیست درخواست‌ها — GET /b2c/v1/travel_requests

پاسخ نمونه

{
  "items": [
    {
      "id": 45,
      "title": "اصفهان به مشهد هتل آوازه مشهد از ‎2025/12/14‎ تا ‎2025/12/18‎",
      "method": "accommodation",
      "budget": 5000000,
      "status": 1,
      "operator_group": "b2c",
      "origin": { "id": 37, "fa_name": "اصفهان", "en_name": "Isfahan" },
      "destination": { "id": 396, "fa_name": "مشهد", "en_name": "Mashhad" },
      "accommodation": { "title": { "fa": "هتل آوازه مشهد" }, "category": { "title": "hotel" } },
      "details": { "rooms": 2, "adults": 3 },
      "requester_id": { "id": 12, "first_name": "علیرضا", "last_name": "احمدی" }
    }
  ],
  "meta": {
    "timestamp": 1733821800,
    "table": { "total": 25, "per_page": 30, "current_page": 1, "last_page": 1 }
  }
}

۲. ایجاد درخواست — POST /b2c/v1/travel_requests

در این درخواست، اپراتور با استفاده از JWT خود به عنوان operator، رکوردی جدید در جدول travel_requests ایجاد می‌کند.

پارامترهای ورودی (JSON Body)

{
  "method": "accommodation",
  "origin": {"id": 37},
  "destination": {"id": 396},
  "accommodation": {"id": 52, "type": "accommodation"},
  "from_date": "2025-12-14",
  "to_date": "2025-12-18",
  "budget": 5000000,
  "cost_center": 8,
  "trip_type": "business",
  "description": "سفر کاری به مشهد",
  "details": { "adults": 3, "children": 1 }
}

خروجی موفق (201 Created)

{
  "payload": {
    "id": 45,
    "title": "اصفهان به مشهد هتل آوازه مشهد از ‎2025/12/14‎ تا ‎2025/12/18‎",
    "budget": 5000000,
    "method": "accommodation"
  },
  "meta": { "timestamp": 1733821800 }
}

۳. مشاهده جزئیات — GET /b2c/v1/travel_requests/{id}

کلیه روابط مرتبط (origin، destination، accommodation، requester و غیره) از جداول مجزا خوانده می‌شوند.

۴. ویرایش — PUT /b2c/v1/travel_requests/{id}

پاسخ نمونه

{
  "payload": {
    "id": 45,
    "status": 3,
    "payment_status": 1,
    "title": "اصفهان به مشهد هتل آوازه مشهد از ‎2025/12/14‎ تا ‎2025/12/18‎"
  },
  "meta": { "timestamp": 1733821880 }
}

۵. حذف — DELETE /b2c/v1/travel_requests/{id}

درخواست با شناسه مشخص حذف می‌شود و مقدار حذف (true/false) بازگردانده می‌شود.

۶. تغییر وضعیت — POST /b2c/v1/travel_requests/{id}/change-status

{
  "operator_id": 5,
  "status": 4,
  "reference_id": 999
}

خروجی موفق

{
  "payload": { "status": true },
  "meta": { "timestamp": 1733821930 }
}

نکات فنی و عملکردی