Créer une réservation familiale avec enfants

Réservation
Réservation
4 routes

Comment créer une réservation familiale incluant des enfants ?

Ce scénario documente un parcours de réservation familiale avec enfants, depuis la recherche de proposition jusqu'à l'identification des voyageurs puis la création de la réservation. Il est utile lorsqu'un flux doit gérer les dates de naissance des enfants, la composition des foyers et la vérification des voyageurs après réservation.

Le parcours crée une proposition familiale, met à jour les voyageurs de la proposition, crée la réservation puis récupère la liste des voyageurs rattachés au dossier.

Vue d'ensemble

Ce scénario aide une application de réservation à gérer un parcours familial dans lequel un ou plusieurs enfants doivent être correctement qualifiés tout au long du flux de proposition et de réservation.

Prérequis

Un x-api-key valide, et lorsque nécessaire accept-language et authorization.
Une composition familiale et des dates de naissance enfants prêtes à être envoyées dans le flux.
L'accept-language utilisé pour créer la réservation doit rester cohérent avec le contexte de création de la proposition.

Résultat attendu

L'application peut créer une proposition familiale, identifier les voyageurs, créer la réservation puis relire les voyageurs liés au dossier.

Process workflow

Legend:

Obligatoire

Optionnel

Créer une proposition famille

Obligatoire

Utilisez POST/v3/proposals/search pour créer une proposition famille.

Prérequis

Préparez les paramètres utiles à l'appel. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide. Vérifiez le body avant appel pour éviter une erreur de validation.

Calling CURL

curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "product-1", "start_date": "2026-07-05", "end_date": "2026-07-12", "attendees": [{"birthdate": "1990-03-12"}]}' \
  "https://api.clubmed.com/v3/proposals/search"

Example answer

[
  {
    "id": "proposal-1",
    "product_id": "product-1",
    "price": {
      "amount": 2890,
      "currency": "EUR"
    },
    "remaining_stock": 4
  }
]

info: Conservez le proposal_id renvoyé pour ajouter ensuite des participants, des services ou finaliser la réservation famille.

Codes de réponse

200 OK : l'opération est prise en compte et la ressource est renvoyée.
400 Bad Request : le body ou les paramètres sont invalides.
404 Not Found : la ressource ciblée est introuvable.

POST/v3/proposals/search

Qualifier les voyageurs de la famille

Obligatoire

Utilisez PUT/v3/proposals/{proposal_id}/attendees pour qualifier les voyageurs de la famille.

Prérequis

Préparez proposal_id. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide. Vérifiez le body avant appel pour éviter une erreur de validation.

Calling CURL

curl -X PUT \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '{"attendees": [{"id": "attendee-1", "first_name": "Jane", "last_name": "Doe", "birthdate": "1990-03-12"}]}' \
  "https://api.clubmed.com/v3/proposals/{proposal_id}/attendees"

Example answer

HTTP/1.1 204 No Content

info: Le succès peut être renvoyé sans body. Relisez la ressource ensuite si vous devez afficher l'état final.

Codes de réponse

204 No Content : l'opération est appliquée avec succès.
400 Bad Request : le body ou les paramètres sont invalides.
404 Not Found : la ressource ciblée est introuvable.

PUT/v3/proposals/{proposal_id}/attendees

Créer la réservation famille

Obligatoire

Utilisez POST/v3/bookings pour créer la réservation familiale une fois les participants de la proposition qualifiés avec les données des enfants.

Prérequis

Préparez les paramètres utiles à l'appel. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide. Vérifiez le body avant appel pour éviter une erreur de validation.

Calling CURL

curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '{"proposal_id": "proposal-1"}' \
  "https://api.clubmed.com/v3/bookings"

Example answer

{
  "booking_id": "booking-1",
  "booking_status": "OPTION",
  "payment_status": "PENDING"
}

info: Conservez le booking_id retourné pour enchaîner avec la vérification des voyageurs ou les étapes de paiement.

Codes de réponse

200 OK : l'opération est prise en compte et la ressource est renvoyée.
400 Bad Request : le body ou les paramètres sont invalides.
404 Not Found : la ressource ciblée est introuvable.

POST/v3/bookings

Récupérer les voyageurs de la réservation

Obligatoire

Utilisez GET/v0/bookings/{booking_id}/attendees pour vérifier que chaque adulte et chaque enfant est correctement rattaché à la réservation familiale créée.

Prérequis

Préparez booking_id. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide.

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v0/bookings/{booking_id}/attendees"

Example answer

[
  {
    "id": "attendee-1",
    "first_name": "Jane",
    "type": "ADULT"
  }
]

info: Utilisez cette relecture pour confirmer que chaque enfant et chaque adulte est rattaché au bon booking.

Codes de réponse

200 OK : les données attendues sont renvoyées.
400 Bad Request : la requête est invalide ou incomplète.
404 Not Found : la ressource demandée est introuvable.

GET/v0/bookings/{booking_id}/attendees