Récupérer les périodes d'ouverture d'un resort

  • Destinations
  • Contenu resort
  • 2 routes
Comment récupérer les dates d'ouverture et les périodes d'exploitation d'un resort ?

Ce scénario explique comment récupérer les dates d'ouverture d'un resort et les compléter avec les périodes d'exploitation, d'événement ou de fermeture exposées par la route de périodes. Il convient aux parcours de contenu produit et d'information opérationnelle.

Le flux commence par les dates d'ouverture puis enrichit le résultat avec la route de périodes pour le même product_id.

Vue d'ensemble

Ce scénario aide une application à exposer les repères calendaires qui décrivent quand un resort est ouvert et quelles périodes spécifiques lui sont appliquées.

Prérequis

  • Un product_id valide.
  • Un header accept-language valide et une x-api-key.
  • Éventuellement un contexte d'autorisation si l'application consommatrice en a besoin.

Résultat attendu

L'application peut afficher la chronologie d'ouverture d'un resort et la compléter avec les périodes d'exploitation, d'événement ou de fermeture utiles aux écrans de contenu ou d'information opérationnelle.

Process workflow

Legend:
Obligatoire
Optionnel
1

Recuperer les dates d'ouverture du produit

Obligatoire

Utilisez GET/v0/products/{product_id}/opening_dates pour recuperer les fenetres d'ouverture d'un resort. Cette premiere lecture permet de verifier rapidement si le produit est ouvert sur la periode ciblee avant d'analyser les periodes plus detaillees.

Prerequis

  • Fournir product_id.
  • Envoyer accept-language et x-api-key.
  • Ajouter date_format si vous souhaitez des dates au format ISO.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v0/products/MPAC/opening_dates?date_format=ISO' \
  -H 'accept: application/json' \
  -H 'accept-language: fr-FR' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

[
  {
    "opening": "2020-12-01",
    "closing": "2020-12-31"
  }
]

info: Reutilisez ces dates comme premier cadre d'ouverture. Le detail par periode est fourni par l'etape periods_info.

Codes de reponse

  • 200 OK : retourne les fenetres d'ouverture du produit.
  • 400 Bad Request : le format de requete ou un parametre est invalide.
  • 404 Not Found : le produit est introuvable.
GET/v0/products/{product_id}/opening_dates
Voir plus
2

Recuperer les periodes detaillees du resort

Optionnel

Utilisez GET/v1/products/{product_id}/periods_info pour recuperer les periodes detaillees rattachees a un resort, comme des periodes d'exclusivite, d'ouverture ou d'autres decoupages operationnels. Cette route complete les dates d'ouverture avec une lecture plus explicite du contexte.

Prerequis

  • Fournir product_id.
  • Envoyer accept-language et x-api-key.
  • Conserver le meme produit et la meme locale que dans l'etape precedente.

Calling CURL

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

Example answer

[
  {
    "type": "EXCLUSIVITY",
    "start_date": "2020-12-01",
    "end_date": "2020-12-31"
  }
]

info: Cette route est utile quand l'application doit expliquer pourquoi une periode est mise en avant ou contrainte, et pas seulement si le resort est ouvert.

Codes de reponse

  • 200 OK : retourne les periodes detaillees disponibles pour le produit.
  • 400 Bad Request : le format de requete ou un parametre est invalide.
  • 404 Not Found : le produit est introuvable.
GET/v1/products/{product_id}/periods_info
Voir plus