Récupérer les informations de période d’un resort

  • Information sur le produit
  • Contenu resort
  • 2 routes
Comment récupérer les périodes d’exploitation, d’événement et de fermeture d’un resort ?

Ce scénario montre comment récupérer les périodes d'exploitation, d'événement et de fermeture d'un resort via l'endpoint de périodes produit.

Vue d'ensemble

Utilisez GET/v1/products/{product_id}/periods_info pour accéder aux informations de période rattachées à un produit. Cela permet d'exposer les fenêtres d'ouverture, périodes d'événements ou périodes de fermeture dans un contexte d'information produit.

Prérequis

  • Le product_id doit être connu.
  • Les headers accept-language et x-api-key sont requis.
  • Les options de requête complémentaires ne sont pas entièrement visibles dans la matière source disponible.

Process workflow

Legend:
Obligatoire
Optionnel
1

Récupérer les périodes d’exploitation du resort

Obligatoire

Utilisez GET/v1/products/{product_id}/periods_info pour récupérer les entrées de période exposées pour un produit, y compris les fenêtres d’exploitation pouvant être affichées dans une page d’information resort.

Prérequis

  • Header accept-language
  • Header x-api-key
  • Header optionnel authorization
  • Path product_id

Calling CURL

curl -X GET "https://api.clubmed.com/v1/products/MPAC/periods_info" \
  -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: Commencez par stocker la liste brute telle que retournée par l’API. Elle constitue le jeu de données de base pour les calendriers, les fiches produit ou les labels opérationnels dans les canaux aval.

Codes de réponse

  • 200 : entrées de période retournées avec succès.
  • 400 : requête invalide ou erreur de validation.
  • 401 : authentification invalide ou absente lorsqu’un contexte protégé est demandé.
  • 403 : accès interdit.
  • 404 : produit inconnu.
GET/v1/products/{product_id}/periods_info
Voir plus
2

Identifier les périodes de fermeture et d’événement

Obligatoire

Utilisez la même réponse GET/v1/products/{product_id}/periods_info pour interpréter les valeurs type retournées et distinguer les périodes d’exploitation, de fermeture ou d’événement dans votre logique de canal.

Prérequis

  • Header accept-language
  • Header x-api-key
  • Header optionnel authorization
  • Path product_id

Calling CURL

curl -X GET "https://api.clubmed.com/v1/products/MPAC/periods_info" \
  -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: La route retourne une liste plate d’entrées de période. C’est à votre application d’interpréter le champ type pour décider si une période doit être affichée comme ouverture, exclusivité, fermeture ou label événementiel.

Codes de réponse

  • 200 : entrées de période retournées avec succès.
  • 400 : requête invalide ou erreur de validation.
  • 401 : authentification invalide ou absente lorsqu’un contexte protégé est demandé.
  • 403 : accès interdit.
  • 404 : produit inconnu.
GET/v1/products/{product_id}/periods_info
Voir plus