Propositions : Parcours de sélection de transport

  • Transport
  • Transport
  • 2 routes
Comment modifier le transport de sa proposition ?

Ce guide détaille la procédure permettant de modifier le transport associé à une proposition.

Le processus couvre les différentes méthodes de recherche, de la requête simplifiée aux filtres avancés (compagnies, escales, etc.).

Le changement de transport s'articule autour de deux étapes clés :

  • Récupération : Identifier les alternatives de transport disponibles.
  • Application : Valider et appliquer le nouveau transport à la proposition.

Prérequis

  • Un proposal_id valide (obtenu via le scénario de création de proposition).

Process workflow

Legend:
Obligatoire
Optionnel
1

Récupérer les transports alternatifs

Obligatoire

Cette route retourne le transport actuellement appliqué ainsi que les alternatives disponibles pour la proposition.

Prérequis

Munissez-vous d'une proposition éligible au transport et de son identifiant. L'API renvoie aussi une limite de validité sur certaines options.

Calling CURL

curl -X POST \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '{"journeys": [{"transport_class": "STANDARD"}]}' \
  "https://api.clubmed.com/v1/proposals/{proposal_id}/available_transports"

Example answer

[
  {
    "id": "transport-1",
    "is_applied_transportation": false,
    "time_validity_limit": "2026-07-01T10:00:00Z",
    "price": {
      "amount": 220,
      "currency": "EUR"
    },
    "total_differential_price": {
      "amount": 80,
      "currency": "EUR"
    },
    "journeys": [
      {
        "travel_sections": [
          {
            "departure_point": "Paris",
            "arrival_point": "Valmorel",
            "transport_class": "STANDARD"
          }
        ]
      }
    ]
  }
]

info: Conservez l'identifiant de l'option choisie: il sera nécessaire pour l'étape d'application et peut expirer après quelques minutes.

Codes de réponse

  • 200 OK : les transports alternatifs sont renvoyés.
  • 400 Bad Request : la proposition n'est pas éligible au transport, ou le JSON est invalide.
  • 404 Not Found : la proposition est introuvable.
POST/v1/proposals/{proposal_id}/available_transports
Voir plus
2

Appliquer le nouveau transport

Obligatoire

Cette route applique un nouveau transport à la proposition à partir de l'identifiant choisi à l'étape précédente.

Prérequis

Réutilisez un identifiant de transport encore valide. Les identifiants retournés par l'API expirent rapidement, en général au bout de quelques minutes.

Calling CURL

curl -X POST \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '{"id": "transport-1"}' \
  "https://api.clubmed.com/v5/proposals/{proposal_id}/transport_details"

Example answer

{
  "id": "transport-1",
  "journeys": [
    {
      "travel_sections": [
        {
          "departure_point": "Paris",
          "arrival_point": "Valmorel",
          "transport_class": "STANDARD"
        }
      ]
    }
  ],
  "price": {
    "amount": 220,
    "currency": "EUR"
  }
}

info: Si l'identifiant n'est plus valide, relancez d'abord la récupération des transports alternatifs pour obtenir une nouvelle option sélectionnable.

Codes de réponse

  • 200 OK ou 201 Created : le nouveau transport est appliqué et détaillé dans la réponse.
  • 400 Bad Request : la proposition n'est pas éligible au transport ou le body est invalide.
  • 404 Not Found : la proposition est introuvable.
POST/v5/proposals/{proposal_id}/transport_details
Voir plus