Lister et consulter un produit Club Med

  • Information sur le produit
  • Prébooking
  • 2 routes
Comment lister les produits Club Med puis consulter le détail d'un produit ?

Cette fonctionnalité permet de consulter la liste des produits disponibles dans le catalogue Club Med, puis d’accéder aux informations détaillées d’un produit spécifique afin de préparer un séjour.

Elle s’appuie généralement sur deux étapes : • récupérer la liste des produits disponibles avec leurs principales informations (destination, catégorie, prix, disponibilité, etc.) • consulter ensuite le détail d’un produit précis à partir de son identifiant (product_id)

Les informations retournées peuvent inclure notamment : • Les informations générales du produit (title, category, destination) • Les caractéristiques du resort (comfort, areas, capacity_max) • Les services disponibles (available_services) • Les informations tarifaires (price, currency, terms_and_conditions) • Les contenus médias et descriptifs (media, description_title) • Les informations de localisation (countries, geographical_area, region)

Ce processus permet à un utilisateur de parcourir les destinations disponibles, comparer les offres et sélectionner un produit correspondant à son projet de voyage.

Vue d'ensemble

Utilisez ce scénario pour parcourir le catalogue Club Med puis consulter le détail complet d'un produit avant d'enchaîner vers des parcours de recherche, de pricing ou de réservation.

Prérequis

  • Disposer d'une x-api-key valide.
  • Envoyer un accept-language cohérent avec le marché ciblé.
  • Conserver le product_id sélectionné pour récupérer ensuite le détail complet du produit.

Résultat attendu

L'application peut lister les produits disponibles, sélectionner un resort ou une croisière, puis réutiliser les données détaillées du produit pour alimenter une fiche produit ou une expérience de préparation du voyage.

Process workflow

Legend:
Obligatoire
Optionnel
1

Lister tous les produits

Obligatoire

Cette route liste les produits du catalogue Club Med avec filtres et pagination.

Prérequis

Utilisez filter, limit et page pour cadrer la recherche. Le Swagger ne demande pas de timestamp sur cette route.

Calling CURL

curl -X GET \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v2/products?limit=20&page=1&filter[type][_eq]=RESORT"

Example answer

[
  {
    "id": "product-1",
    "label": "Club Med Valmorel",
    "country_code": "FR",
    "type": "RESORT"
  }
]

info: Commencez par cette route pour obtenir les identifiants produits, puis enchaînez avec la route de détail pour enrichir la page.

Codes de réponse

  • 200 OK : la liste des produits est renvoyée.
  • 206 Partial Content : la liste est paginée.
  • 400 Bad Request : paramètres invalides.
  • 416 Range Not Satisfiable : pagination invalide.
GET/v2/products
Voir plus
2

Obtenir les détails d'un produit

Obligatoire

Cette route retourne le détail d'un produit Club Med à partir de son identifiant.

Prérequis

Munissez-vous de l'identifiant produit renvoyé par la liste. Aucun paramètre supplémentaire n'est requis.

Calling CURL

curl -X GET \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v2/products/{product_id}"

Example answer

{
  "id": "product-1",
  "label": "Club Med Valmorel",
  "country_code": "FR",
  "type": "RESORT",
  "description": "Family resort in the Alps",
  "pictures": [
    "https://example.com/product.jpg"
  ]
}

info: Cette réponse détaillée sert à alimenter une fiche produit, un PDP ou une prévisualisation plus riche.

Codes de réponse

  • 200 OK : le détail du produit est renvoyé.
  • 400 Bad Request : paramètres invalides.
  • 404 Not Found : produit introuvable.
GET/v2/products/{product_id}
Voir plus