Mon séjour en Montagne

Documentation des widgets et API

La plateforme distribuée Mon séjour en Montagne met à votre disposition des Widgets et des API.
Pour tirer parti de ces outils, nous vous conseillons de vous référer à la documentation pour réaliser la meilleure intégration possible !

Lors de leur invocation, les widgets doivent être paramétrés avec un ensemble d'options de configuration. La plupart de ces options sont transverses à tous les widgets et sont listées ci-dessous.

Certains widgets ont aussi des options additionnelles qui leurs sont propres et sont documentées dans la section options spécifiques pour chacun des widgets.

Option resort

Type Nombre entier
Obligatoire Oui

L'option resort spécifie le code de la station pour laquelle vous souhaiter exécuter un widget. Cette option est obligatoire pour l'ensemble des widgets.

Note Vous pouvez trouvez votre code station en utilisant l'outil de configuration des widgets ou en requêtant le service suivant : https://api.msem.tech/api/location/resorts

Option lang

Type Chaîne
Obligatoire Non
Par défaut fr

L'option lang spécifie le code de la langue dans laquelle afficher le widget. Ce code doit être le code ISO 639 de la langue sur 2 caractères (alpha-2).

Note La localisation n'a pour le moment été prise en charge que pour fr et en !

Option channel

Type Chaîne
Obligatoire Oui

L'option channel spécifie le canal sur lequel va s'exécuter le widget. Si nécessaire, ce code vous sera attribué lors de la phase d'intégration, une fois le contrat signé avec la plateforme.

Cette option est obligatoire pour l'ensemble des widgets.

Note Le canal influe sur la marque, au sein du widget et dans les mails envoyés aux clients. Il est aussi utilisé pour refléter les commissions définies au contrat.

Option facet

Type Nombre entier (0 ou 1)
Obligatoire Non
Par défaut 0

L'option facet spécifie si le widget s'exécute en mode "été" ou en mode "hiver". La valeur 0 signifie hiver et 1 signifie été.

Note La facette influe principalement sur les partenariats :

  • pour hiver, on propose les marchands "hiver" et "été et hiver".
  • pour été, on propose les marchands "été" et "été et hiver". Dans certains cas, la facette influe aussi sur les contenus (photos, descriptifs...)

Option preview

Type Booléen
Obligatoire Non
Par défaut false

L'option preview spécifie si le widget s'exécute en mode "prévisualisation". Ce mode, utilisé pour les tests, permet d'accéder à l'offre des marchands même si celle-ci n'est pas finalisée.

Attention Cette option servant à des fins de test, vous devez être vigilants et ne PAS l'activer en production.

Par ailleurs, pour un test ponctuel, vous pouvez ajouter le paramètre preview=true dans l'URL de la page embarquant le widget.