Recherche avec flexibilité (durée + dates)

  • Information sur le produit
  • Calendrier shopping
  • 2 routes
Comment explorer les dates et durées réservables avant de choisir un départ ?

Ce scénario documente un parcours de recherche flexible qui combine les dates réservables et l'inspection du calendrier afin d'aider un utilisateur à explorer les durées et fenêtres de dates avant de sélectionner un départ précis.

Vue d'ensemble

La séquence démarre avec GET/v1/products/{product_id}/bookable_dates pour identifier les dates et durées éligibles, puis utilise GET/v2/products/{product_id}/calendar pour consulter le calendrier tarifaire sur les critères retenus.

Prérequis

  • Le product_id doit être connu.
  • Des filtres de date et de durée peuvent être requis selon le mode d'exploration.
  • accept-language et x-api-key sont requis sur les appels documentés.

Process workflow

Legend:
Obligatoire
Optionnel
1

Explorer les dates et durées réservables

Obligatoire

Utilisez GET/v1/products/{product_id}/bookable_dates pour découvrir quelles dates de départ sont réservables et quelles durées de séjour sont disponibles pour chaque date avant de choisir un contexte de recherche précis.

Prérequis

  • Header accept-language
  • Header x-api-key
  • Header optionnel authorization
  • Path product_id
  • Query optionnelle departure_option_id
  • Query optionnelle first_date
  • Query optionnelle last_date

Calling CURL

curl --get "https://api.clubmed.com/v1/products/MPAC/bookable_dates" \
  -H "accept-language: fr-FR" \
  -H "x-api-key: <your-api-key>" \
  --data-urlencode "first_date=2022-04-15" \
  --data-urlencode "last_date=2022-06-15"

Example answer

{
  "months": [
    {
      "id": 202001,
      "days": [
        {
          "id": 20200101,
          "availabilities": [
            {
              "status": "OPEN",
              "sibling_id": "CHAC_SUMMER",
              "durations": [7]
            }
          ]
        }
      ]
    }
  ]
}

info: Cette route est utile quand l’utilisateur reste flexible à la fois sur la date de départ et sur la durée. Réutilisez ensuite le jour et la durée choisis dans l’étape de calendrier tarifaire.

Codes de réponse

  • 200 : dates réservables retournées avec succès.
  • 400 : requête invalide ou erreur de validation.
  • 401 : authentification invalide ou absente lorsqu’un contexte protégé est demandé.
  • 404 : produit inconnu.
GET/v1/products/{product_id}/bookable_dates
Voir plus
2

Consulter le calendrier pour les critères sélectionnés

Obligatoire

Utilisez GET/v2/products/{product_id}/calendar une fois que l’utilisateur a resserré la durée et le contexte voyageurs issus de l’étape d’exploration flexible.

Prérequis

  • Header accept-language
  • Header x-api-key
  • Header optionnel authorization
  • Path product_id
  • Query requise duration
  • Query optionnelle departure_option_id
  • Query optionnelle number_attendees
  • Query optionnelle birthdates
  • Query optionnelle first_date
  • Query optionnelle last_date

Calling CURL

curl --get "https://api.clubmed.com/v2/products/MPAC/calendar" \
  -H "accept-language: fr-FR" \
  -H "x-api-key: <your-api-key>" \
  --data-urlencode "duration=7" \
  --data-urlencode "number_attendees=2" \
  --data-urlencode "first_date=2022-04-15" \
  --data-urlencode "last_date=2022-06-15"

Example answer

{
  "months": [
    {
      "id": "201511",
      "days": [
        {
          "id": "20151129",
          "availability": "OPEN",
          "price": {
            "currency": "EUR"
          },
          "terms_and_conditions": {
            "duration": 7,
            "package": "AI",
            "departure_city": {
              "id": "PAR",
              "label": "Paris"
            }
          }
        }
      ]
    }
  ]
}

info: Cette étape transforme une recherche flexible en vue de comparaison tarifaire. Utilisez les jours retournés pour décider quelle date de départ alimentera la prochaine étape de proposition ou de réservation.

Codes de réponse

  • 200 : calendrier retourné avec succès.
  • 400 : duration manquante, requête invalide ou erreur de validation.
  • 401 : authentification invalide ou absente lorsqu’un contexte protégé est demandé.
  • 404 : produit inconnu.
GET/v2/products/{product_id}/calendar
Voir plus