Calendrier des événements shopping

  • Calendrier shopping
  • 1 route
Comment récupérer les informations produit nécessaires pour alimenter un calendrier shopping ?

Ce scénario explique comment récupérer les informations produit utilisées pour alimenter une vue calendrier ou une surface de merchandising shopping. Il convient aux interfaces qui doivent exposer les offres disponibles avec leurs principaux repères produit.

Le flux s'appuie sur la consultation du catalogue produit pour afficher des informations structurées selon le marché ou la locale.

Vue d'ensemble

Ce scénario permet d'exposer des données produit utiles à une expérience de shopping pilotée par calendrier.

Prérequis

  • Un contexte de marché ou de locale cohérent avec la recherche produit.
  • Les headers requis par l'API de catalogue.
  • Les filtres éventuels nécessaires pour restreindre le périmètre de recherche.

Résultat attendu

L'application peut récupérer une base produit structurée pour alimenter une vue calendrier, une liste d'offres ou une surface de merchandising.

1

Explorer le catalogue produit pour le calendrier shopping

Optionnel

Utilisez GET/v2/products pour lister les produits qui alimenteront votre calendrier shopping. Cette route permet de filtrer les produits a afficher, de paginer le catalogue et de recuperer les informations minimales necessaires avant de construire une vue calendrier ou une navigation merchandising.

Prerequis

  • Envoyer accept-language et x-api-key.
  • Ajouter un filter, limit et page si vous souhaitez restreindre le catalogue.
  • Conserver les product_id retournes pour les appels de detail, de calendrier ou de prix.

Calling CURL

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

Example answer

[
  {
    "id": "CHAC_WINTER",
    "title": "Chamonix Mont-Blanc",
    "opening_status": "OPEN",
    "destination": {
      "geographical_area": {
        "label": "Alps"
      }
    },
    "price": {
      "currency": "EUR",
      "best_price": {
        "per_trip": 824
      }
    }
  }
]

info: Reutilisez id, title, opening_status et le premier niveau de prix pour alimenter une page calendrier ou une tuile produit avant de charger le detail complet.

Codes de reponse

  • 200 OK : retourne la liste des produits correspondant au filtre courant.
  • 206 Partial Content : la reponse est paginee et d'autres pages restent disponibles.
  • 400 Bad Request : un filtre, une pagination ou un parametre est invalide.
  • 416 Requested Range Not Satisfiable : la plage de pagination demandee est incoherente.
GET/v2/products
Voir plus