Parcourir les produits et consulter une fiche produit

  • Information sur le produit
  • Prébooking
  • 2 routes
Comment lister les produits disponibles puis consulter un produit précis ?

Ce scénario présente le parcours de consultation du catalogue produit : récupération de la liste des produits, puis lecture détaillée d'un produit pour afficher ses informations clés.

Il convient aux interfaces de découverte, aux moteurs de recherche et aux pages produit affichées avant la réservation.

Vue d'ensemble

Le parcours commence par la récupération du catalogue produit, puis s'appuie sur l'identifiant d'un produit pour charger sa fiche détaillée.

Prérequis

  • Aucun prérequis fonctionnel n'est nécessaire pour lister les produits.
  • Conserver le product_id retourné par la première étape pour consulter le détail.

Process workflow

Legend:
Obligatoire
Optionnel
1

Lister les produits disponibles

Obligatoire

Utilisez GET/v2/products pour lister les produits disponibles.

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.

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v2/products?limit=20&page=1"

Example answer

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

info: Sélectionnez un product_id dans cette liste avant d'appeler la route de détail produit.

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/v2/products
Voir plus
2

Consulter le détail d'un produit

Obligatoire

Utilisez GET/v2/products/{product_id} pour consulter le détail d'un produit.

Prérequis

Préparez product_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/v2/products/{product_id}"

Example answer

{
  "id": "product-1",
  "label": "Club Med Valmorel",
  "country_code": "FR",
  "type": "RESORT",
  "description": "Family resort in the Alps"
}

info: Réutilisez cette réponse pour enrichir la fiche produit avec ses contenus détaillés, services et informations de localisation.

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/v2/products/{product_id}
Voir plus