Migration of the endpoint GET /v4/proposals/{proposal_id}/transport_details to GET /v5/proposals/{proposal_id}/transport_details

Context

Upgrade from GET - ​/v4/proposals/{proposal_id}/transport_details to GET - ​/v5/proposals/{proposal_id}/transport_details

⭐ 2 Key benefits :

• Get the new time_validity_limit field to retrieve the time validity limit of the current transport (if it exists)
• With the new structure (the whole transport falls into the new "journeys" section), in the future we will be able to add more general fields related to the transport

Impacts

Route to call :

• GET - ​/v5/proposals/{proposal_id}/transport_details

Output

{
+ "time_validity_limit": "20250415T10:23:00.234Z",
! "journeys": [
    {
      "way": "INBOUND",
      "total_duration_in_min": 120,
      "travel_sections": [
        {
          "attendees": [
            {
              "id": "A",
              "ticket_number": "147-5250548512",
              "status": "VALIDATED",
              "reservation_number": "ZTG2MO",
              "pnr": "UP7XZH"
            }
          ],
          "departure": {
            "city": {
              "id": "PAR",
              "label": "PARIS"
            },
            "location": {
              "id": "CDG",
              "label": "PARIS-ROISSY CDG",
              "terminal_code": "2A"
            },
            "date": "2022-04-15",
            "time": "17:00:00"
          },
          "arrival": {
            "city": {
              "id": "PAR",
              "label": "PARIS"
            },
            "location": {
              "id": "CDG",
              "label": "PARIS-ROISSY CDG",
              "terminal_code": "2A"
            },
            "date": "2022-04-15",
            "time": "17:00:00"
          },
          "transport": {
            "type": "PLANE",
            "class": "PLANE_ECONOMY",
            "company": {
              "operator": {
                "id": "SQ",
                "label": "SINGAPORE AIRLINES",
                "logo": "http://www.airfrance.fr/logo",
                "_links": [
                  {
                    "rel": "self",
                    "method": "GET",
                    "href": "https://api.clubmed.com/products",
                    "label": "A label"
                  }
                ]
              },
              "exploiter": {
                "id": "SQ",
                "label": "SINGAPORE AIRLINES",
                "logo": "http://www.airfrance.fr/logo",
                "_links": [
                  {
                    "rel": "self",
                    "method": "GET",
                    "href": "https://api.clubmed.com/products",
                    "label": "A label"
                  }
                ]
              }
            },
            "travel_number": "SQ1234",
            "baggage": {
              "quantity": 2,
              "weight": 23,
              "unit": "KG"
            },
            "vehicle_type": "BOEING 747",
            "reference": "SQ1234",
            "fare_class": "U"
          },
          "clubmed_transport": false,
          "flight_code": "THEO9E",
          "cancellation_policy_type": "THEO",
          "technical_stops": 0,
          "connection_duration_in_min": 130,
          "stopover_duration_in_min": 130
        }
      ]
    }
  ]
}