Consulter les thématiques principales d'un produit

  • Information sur le produit
  • Contenu resort
  • 1 route
Comment récupérer les thématiques principales mises en avant pour un produit ?

Utilisez ce scénario pour récupérer les thématiques principales associées à un produit. Il est utile pour mettre en avant le positionnement du resort, ses promesses d'expérience ou ses blocs éditoriaux dans une expérience de découverte produit.

La route retourne des thématiques structurées avec titres, descriptions, images, thèmes enfants éventuels et informations de services quand elles sont disponibles.

Vue d'ensemble

Ce scénario documente la récupération des thématiques principales d'un produit avec la version la plus récente disponible de l'endpoint de thematics. La réponse peut être réutilisée pour construire des sections éditoriales, enrichir une page produit ou mettre en avant les piliers clés de l'expérience resort.

Prérequis

  • Un product_id valide
  • Une x-api-key valide
  • Un header accept-language correspondant à une locale supportée

Résultat attendu

À la fin de ce scénario, vous pouvez afficher les thématiques principales du produit, leurs descriptions, leurs visuels associés et les informations de contexte utiles dans une expérience publique.

1

Récupérer les thématiques principales

Obligatoire

Cette route retourne les thématiques principales d'un produit avec leur contenu éditorial associé. Elle permet d'afficher les grands piliers d'expérience d'un resort, leurs visuels et des informations de contexte réutilisables sur une page publique.

Prérequis

  • Un product_id valide, par exemple MPAC
  • Une x-api-key valide
  • Un header accept-language, par exemple fr-FR

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v2/products/MPAC/thematics"

Example answer

[
  {
    "id": "cruises_theme_golf",
    "children": ["TH_SAVOUR"],
    "type": "FOOD_AND_BEVERAGE",
    "is_specific_to_product": true,
    "title": "FOOD AND DRINK",
    "sub_title": "Discover a world of flavours",
    "description": "With dining venues available for each meal, every member of family will find exatly what they want",
    "images": [
      {
        "url": "http://image.jpg",
        "type": "COMMON"
      }
    ],
    "activity_count": {
      "on_demand": 5,
      "included_activity": 4
    }
  }
]

info: La route peut retourner plusieurs thématiques. Utilisez filter, limit et page si vous devez cibler un sous-ensemble ou paginer un volume important de contenu.

Codes de réponse

  • 200 OK : les thématiques principales du produit sont retournées
  • 206 Partial Content : la réponse a été tronquée par pagination
  • 400 Bad Request : un paramètre obligatoire est manquant ou invalide
  • 404 Not Found : le product_id ne correspond à aucun produit connu
  • 416 Requested Range Not Satisfiable : la plage demandée n'est pas exploitable
GET/v2/products/{product_id}/thematics
Voir plus