Récupérer les highlights d'un resort et ses must-try experiences

  • Information sur le produit
  • Contenu resort
  • 4 routes
Comment récupérer les forces d'un resort et les expériences à ne pas manquer ?

Ce scénario explique comment résoudre un produit resort, lire ses données produit principales, récupérer les highlights éditoriaux puis isoler les must-try experiences dans ce même flux.

Vue d'ensemble

La séquence démarre par la résolution du produit resort, puis combine l'information produit générique avec le flux de highlights éditoriaux pour exposer à la fois les points forts du resort et les must-try experiences.

Prérequis

  • Un product_id valide doit être résolu ou sélectionné.
  • accept-language et x-api-key sont requis sur les appels documentés.
  • Les must-try experiences sont récupérées depuis le flux de highlights grâce au filtre type == MUST_TRY_EXPERIENCES.

Process workflow

Legend:
Obligatoire
Optionnel
1

Identifier le product_id du resort

Obligatoire

Utilisez GET/v2/products pour identifier le product_id du resort.

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: Conservez le product_id du resort retenu pour interroger ensuite ses highlights et ses must-try experiences.

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

Lire les forces du produit

Obligatoire

Utilisez GET/v2/products/{product_id} pour lire les forces du 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: Reuse the returned highlights to feed a resort page or a reassurance block.

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
3

Récupérer les highlights éditoriaux du resort

Obligatoire

Utilisez GET/v0/products/{product_id}/highlights pour récupérer les highlights éditoriaux qui décrivent les principaux points forts du resort.

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/v0/products/{product_id}/highlights"

Example answer

[
  {
    "id": "highlight-1",
    "title": "Ski-in / ski-out",
    "type": "RESORT_HIGHLIGHT"
  }
]

info: Réutilisez les titres, types et tags des highlights pour construire le bloc éditorial du resort ou préparer le filtre must-try.

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/v0/products/{product_id}/highlights
Voir plus
4

Récupérer les must-try experiences depuis les highlights

Optionnel

Utilisez GET/v0/products/{product_id}/highlights pour isoler les éléments de type MUST_TRY_EXPERIENCES dans le flux de highlights du resort.

Prérequis

Préparez product_id. Ajoutez accept-language et x-api-key. Utilisez le filtre type==MUST_TRY_EXPERIENCES pour ne conserver que les expériences à ne pas manquer.

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v0/products/{product_id}/highlights?filter=type==MUST_TRY_EXPERIENCES"

Example answer

[
  {
    "id": "BALC_must_try_01",
    "title": "GET CRAFTY",
    "type": "MUST_TRY_EXPERIENCES",
    "description": "Experience the colours and textures of Balinese art in the newly constructed Arts & Crafts studio.",
    "image": "http://mypicture01.jpg",
    "theme": "family",
    "tags": ["tag1"]
  }
]

info: Le type retourné permet de distinguer les must-try experiences des autres highlights éditoriaux sans dépendre d'une route dédiée dépréciée.

Codes de réponse

  • 200 OK : les highlights filtrés sont renvoyés pour le resort demandé.
  • 400 Bad Request : product_id ou le filtre transmis est invalide.
  • 404 Not Found : le produit demandé est inconnu.
GET/v0/products/{product_id}/highlights
Voir plus