Découvrir

Use Club Med API to create your application

L’API Club Med est conçue pour permettre aux partenaires et intégrateurs de se connecter directement aux services numériques du Club Med — que ce soit pour rechercher des séjours, gérer des propositions commerciales, effectuer des réservations ou accéder aux données d’un compte client.

Présentation globale

L'API Club Med est une plateforme moderne RESTful qui expose les ressources principales utilisées par les systèmes internes et externes du Club Med. Elle permet de créer, lire, mettre à jour et supprimer des données liées aux séjours et aux opérations commerciales.

Elle est organisée en versions (v0, v2, v3, etc.), où chaque version apporte des améliorations, des routes additionnelles et des intégrations enrichies. Par exemple, la v3 introduit des optimisations de performance pour la recherche de propositions.

Objectifs principaux

L'API a été conçue pour :

  • Connecter des systèmes tiers (sites web, agences partenaires, outils CRM, applications mobiles)
  • Automatiser les flux métier (recherche d'offres, génération de devis, personnalisation des services)
  • Centraliser la gestion des données clients et séjours dans un écosystème sécurisé
  • Garantir la cohérence des expériences digitales sur différents canaux

Domaines fonctionnels clés

Les routes de l'API sont regroupées en plusieurs grands domaines :

Proposals (Propositions de séjour)

  • Créer et rechercher des propositions commerciales
  • Gérer les participants, dates et types de chambre

Bookings (Réservations)

  • Transformer une proposition en réservation réelle
  • Ajouter ou modifier les services et options (transport, transfert, garde d'enfants)

Services additionnels

  • Interroger la liste des services disponibles dans un resort
  • Affecter des supplémentaires aux séjours

Accounts & Authentication

  • Connecter des comptes clients
  • Récupérer ou mettre à jour les informations du profil

Resorts & Offers

  • Explorer les resorts disponibles avec leurs caractéristiques
  • Filtrer par destination, saison ou disponibilité

Sécurité et ouverture

L'API repose sur une authentification sécurisée via tokens OAuth2. Les échanges sont chiffrés en HTTPS. Chaque intégrateur reçoit des identifiants d'environnement sandbox et production, facilitant les tests et déploiements.

Intégration typique

Une intégration typique implique les étapes suivantes :

  1. Authentification du partenaire
  2. Recherche de séjours via /v3/proposals/search
  3. Sélection et ajustement des services via /v0/additional_services
  4. Ajout des participants et validation de la réservation via /v3/bookings

Un scénario API contient généralement 5 à 8 routes couvrant le cycle complet du voyageur, de la recherche à la confirmation.

Évolution continue

L'équipe Club Med publie régulièrement des notes de version, permettant de suivre :

  • Les nouvelles routes et paramètres
  • Les dépréciations
  • Les optimisations de performance
  • Les nouvelles intégrations (TripAdvisor, childcare, etc.)