Meilleurs prix produits

  • Shopping
  • 1 route
Comment rechercher des prix indicatifs pour un ou plusieurs produits ?

Ce scénario explique comment rechercher des prix indicatifs pour un ou plusieurs produits selon des critères de voyage comme les dates, la durée ou la composition voyageurs. Il convient aux parcours shopping, comparaison et pré-réservation qui ont besoin d'un niveau de prix avant la création d'une proposition.

Le flux repose sur une seule route de recherche tarifaire et retourne les meilleurs blocs de prix indicatifs à exploiter dans une interface shopping.

Vue d'ensemble

Ce scénario aide une interface shopping à récupérer des prix indicatifs sans créer de proposition.

Prérequis

  • Les identifiants produit ou le contexte commercial à évaluer.
  • Un header accept-language valide et une x-api-key.
  • Les critères de voyage attendus par la route, comme les dates, la durée, le nombre de participants et le contexte transport si nécessaire.

Résultat attendu

L'application peut comparer des prix indicatifs pour un ou plusieurs produits et réutiliser le contexte tarifaire retourné pour orienter la suite du parcours shopping.

1

Rechercher des prix indicatifs

Obligatoire

Utilisez GET/v1/search_price pour recuperer des meilleurs prix indicatifs sur un ou plusieurs produits avant toute creation de proposition. Cette route est utile pour l'inspiration, le merchandising ou la comparaison de prix quand vous souhaitez afficher un ordre de grandeur sans persister de dossier.

Prerequis

  • Envoyer accept-language et x-api-key.
  • Fournir les criteres principaux en query, notamment product_id, duration et les dates de voyage.
  • Ajouter la composition voyageurs, par exemple number_attendees et birthdates, lorsque la tarification depend de l'age.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v1/search_price?product_id=MPAC&duration=7&first_date=2026-07-01&last_date=2026-08-31&number_attendees=2' \
  -H 'accept: application/json' \
  -H 'accept-language: fr-FR' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

{
  "currency": "EUR",
  "amount": 2890,
  "breakdown": [
    {
      "label": "Sejour",
      "amount": 2500
    },
    {
      "label": "Transport",
      "amount": 390
    }
  ]
}

info: Cette route reste informative. Si l'utilisateur veut bloquer du stock ou poursuivre vers la reservation, il faut ensuite basculer vers une recherche de proposition.

Codes de reponse

  • 200 OK : retourne un meilleur prix indicatif pour les criteres soumis.
  • 400 Bad Request : un parametre de query est manquant, invalide ou incoherent.
  • 401 Unauthorized : non documente dans l'extrait Swagger utilise.
  • 404 Not Found : non documente dans l'extrait Swagger utilise.
GET/v1/search_price
Voir plus