Consulter les offres Club Med

  • Shopping
  • 2 routes
Comment récupérer la liste des offres Club Med puis consulter leur détail ?

Ce scénario explique comment lister les offres commerciales Club Med disponibles, puis consulter le détail d'une offre pour afficher son contenu éditorial et ses produits associés. Il convient aux parcours marketing, shopping et mise en avant d'opérations commerciales.

Le flux part de la liste des offres, puis réutilise un offer_id pour accéder au détail complet de l'offre retenue.

Vue d'ensemble

Ce scénario aide une interface à exposer les offres commerciales Club Med et à approfondir le contenu d'une offre donnée.

Prérequis

  • Un header accept-language correspondant au marché ciblé.
  • Une x-api-key valide.
  • Un offer_id retourné par la première étape pour lire le détail de l'offre.

Résultat attendu

L'application peut afficher une liste d'offres, puis détailler une offre avec ses arguments marketing, ses produits associés et ses informations utiles à l'affichage.

Process workflow

Legend:
Obligatoire
Optionnel
1

Recuperer les offres disponibles

Obligatoire

Utilisez GET/v1/offers pour recuperer les offres commerciales exposees pour la locale courante avant d'en selectionner une a afficher en detail.

Prerequis

  • Envoyer accept-language et x-api-key.
  • Ajouter un filter uniquement si vous souhaitez reduire la liste retournee.
  • Reutiliser la meme locale que dans le reste du parcours commercial.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v1/offers' \
  -H 'accept: application/json' \
  -H 'accept-language: fr-FR' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

[
  {
    "id": "TFO",
    "label": "Family offer",
    "short_label": "Family",
    "seo_label": "family-offer",
    "type": "PROMOTION",
    "color": "#FF6600"
  }
]

info: Reutilisez l'offer_id retourne pour ouvrir le contenu detaille de l'offre choisie a l'etape suivante.

Codes de reponse

  • OK Response (200): retourne la liste des offres disponibles pour la locale courante.
  • Error (400): la requete ou le filtre soumis est invalide.
  • Error (401): non documente dans le Swagger.
  • Error (404): non documente dans le Swagger.
GET/v1/offers
Voir plus
2

Recuperer le detail d'une offre

Obligatoire

Utilisez GET/v1/offers/{offer_id} pour recuperer le contenu detaille d'une offre commerciale apres l'avoir selectionnee dans la liste.

Prerequis

  • Reutiliser un offer_id valide.
  • Envoyer accept-language et x-api-key.
  • Conserver la meme locale que dans l'etape de listing pour garder des labels et un SEO coherents.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v1/offers/TFO' \
  -H 'accept: application/json' \
  -H 'accept-language: fr-FR' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

{
  "id": "TFO",
  "label": "Family offer",
  "description": "Special conditions for family bookings",
  "terms_and_conditions": "Offer valid on selected departures",
  "codes": ["FRFAM"],
  "products": [
    {
      "id": "ALHC_WINTER",
      "label": "ALPES HUEZ"
    }
  ]
}

info: Le detail d'offre permet d'exposer le contenu marketing, les produits eligibles et le code commercial reutilisable dans des parcours de recherche ou de pricing.

Codes de reponse

  • OK Response (200): retourne le detail complet de l'offre selectionnee.
  • Error (400): la requete est invalide ou l'offer_id fourni est mal forme.
  • Error (401): non documente dans le Swagger.
  • Error (404): non documente dans le Swagger.
GET/v1/offers/{offer_id}
Voir plus