Récupérer logements d'un produit

  • Chambres
  • Contenu resort
  • 1 route
Comment récupérer les hébergements disponibles pour un produit Club Med ?

Ce scénario explique comment récupérer le catalogue d'hébergements exposé pour un produit Club Med. Il sert à afficher les chambres, variantes d'hébergement ou informations de logement avant de poursuivre un parcours de proposition ou de réservation.

Vue d'ensemble

Utilisez GET/v2/products/{product_id}/accommodations pour lire l'inventaire des hébergements disponibles pour un produit donné. Cette route est généralement utilisée en amont d'un parcours shopping, proposition ou réservation.

Prérequis

  • Le product_id doit être connu.
  • Les headers accept-language et x-api-key sont requis.
  • Les options de filtrage complémentaires ne sont pas entièrement visibles dans la matière source disponible.
1

Récupérer les logements du produit

Obligatoire

Utilisez GET/v2/products/{product_id}/accommodations pour récupérer la liste des logements exposés pour un produit, avec les métadonnées nécessaires à l’affichage, au filtrage et à la comparaison des chambres.

Prérequis

  • Header accept-language
  • Header x-api-key
  • Path product_id
  • Query optionnelle stay_date
  • Query optionnelle filter
  • Query optionnelle sort
  • Query optionnelle date_format

Calling CURL

curl --get "https://api.clubmed.com/v2/products/MPAC/accommodations" \
  -H "accept-language: fr-FR" \
  -H "x-api-key: <your-api-key>" \
  --data-urlencode "stay_date=20100430" \
  --data-urlencode "date_format=ISO"

Example answer

[
  {
    "id": "A2",
    "label": "Club room",
    "comfort_type": {
      "id": "comfort_type_club",
      "label": "Club"
    },
    "capacity": {
      "min": 1,
      "max": 4
    },
    "area": {
      "min": 39,
      "max": 39,
      "unit": "m²"
    },
    "services": [
      {
        "id": "MST_ACT_SERLGT_000311",
        "label": "Bottle of water"
      }
    ],
    "restriction_information": [
      {
        "id": "restriction01",
        "description": "Certain Room types may be temporarily unavailable due to reduced Resort capacity."
      }
    ]
  }
]

info: La réponse mélange des champs descriptifs, opérationnels et merchandising. Utilisez capacity, comfort_type, services, images et les restrictions pour piloter à la fois les facettes et les fiches chambre.


Codes de réponse

  • 200 : logements retournés avec succès.
  • 400 : requête invalide ou erreur de validation.
  • 403 : accès interdit.
  • 404 : produit inconnu.
GET/v2/products/{product_id}/accommodations
Voir plus