Calendrier de prix

  • Information sur le produit
  • Calendrier shopping
  • 1 route
Comment récupérer le calendrier tarifaire d’un produit resort ?

Ce scénario explique comment récupérer le calendrier tarifaire d'un produit afin de comparer les dates, les durées et les signaux de prix avant de lancer une recherche ou un parcours de proposition.

Vue d'ensemble

Utilisez GET/v2/products/{product_id}/calendar pour exposer la vue calendrier rattachée à un produit. Cela permet de comparer les périodes disponibles, les niveaux de prix et les conditions liées aux dates avant de choisir un départ.

Prérequis

  • Le product_id doit être connu.
  • Certains paramètres de requête comme duration peuvent être requis selon le cas d'usage.
  • accept-language et x-api-key sont requis sur l'appel documenté.
1

Récupérer le calendrier de prix

Obligatoire

Utilisez GET/v2/products/{product_id}/calendar pour récupérer un calendrier tarifaire pour un produit dès que le parcours connaît déjà la durée visée.

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-05-15"

Example answer

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

info: La réponse calendrier sert surtout à comparer. Utilisez availability, les indicateurs de prix et terms_and_conditions pour mettre en avant les meilleurs départs avant un parcours de réservation plus profond.

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