Récupérer les médias d’un resort

  • Contenu resort
  • 2 routes
Comment récupérer les photos et vidéos d’un produit resort ?

Ce scénario explique comment récupérer les assets visuels associés à un produit resort afin de les réutiliser dans une fiche produit, une galerie destination ou une surface promotionnelle.

Le flux combine l’endpoint des photos et l’endpoint des vidéos pour exposer les principaux médias disponibles pour un même product_id.

Vue d'ensemble

Utilisez ce scénario pour récupérer les médias visuels associés à un produit resort. Il est utile lorsqu’une expérience digitale doit afficher une image hero, une galerie photo ou des contenus vidéo sur une page produit ou destination.

Prérequis

  • Un product_id valide.
  • Les en-têtes accept-language et x-api-key.
  • Un composant front ou CMS capable de réutiliser les URLs d’images et de vidéos renvoyées par l’API.

Résultat attendu

L’application peut récupérer les principales photos et vidéos d’un resort et les réutiliser pour construire une narration visuelle, une galerie ou des blocs promotionnels.

Process workflow

Legend:
Obligatoire
Optionnel
1

Récupérer les photos du resort

Obligatoire

Utilisez GET/v1/products/{product_id}/pictures pour récupérer les photos associées à un produit resort et exposer les assets image nécessaires à une galerie ou à une zone hero.

Prerequis

  • Connaître un product_id valide.
  • Envoyer accept-language et x-api-key.
  • Appeler cette étape lorsque l’expérience a besoin d’images fixes plutôt que d’assets vidéo.

Calling CURL

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

Example answer

[
  {
    "url": "http://image.jpg",
    "keywords": [
      "MAIN_KEY_VISUAL"
    ]
  }
]

info: Réutilisez url pour afficher l’image et keywords pour distinguer un visuel principal d’une image de galerie lorsque votre front gère une hiérarchie média.

Codes de reponse

  • OK Response (200): les photos liées au produit sont renvoyées.
  • Error (400): la requête est invalide ou le product_id est mal formé.
  • Error (401): non documente dans le Swagger.
  • Error (403): l’accès aux photos du produit est refusé dans le contexte courant.
  • Error (404): le produit est inconnu ou introuvable.
GET/v1/products/{product_id}/pictures
Voir plus
2

Récupérer les vidéos du resort

Optionnel

Utilisez GET/v0/products/{product_id}/videos pour récupérer les URLs vidéo associées à un produit resort et compléter les assets image renvoyés par la route des photos.

Prerequis

  • Connaître un product_id valide.
  • Envoyer accept-language et x-api-key.
  • Appeler cette étape lorsque l’expérience a besoin de contenus vidéo en complément des images fixes.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v0/products/{product_id}/videos' \
  -H 'accept: application/json' \
  -H 'accept-language: fr-FR' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

[
  "http://image.jpg"
]

info: La route renvoie directement des URLs vidéo. Réutilisez-les pour intégrer un player, enrichir un hero ou compléter une galerie resort avec du contenu animé.

Codes de reponse

  • OK Response (200): les URLs vidéo liées au produit sont renvoyées.
  • Error (400): la requête est invalide ou le product_id est mal formé.
  • Error (401): non documente dans le Swagger.
  • Error (404): le produit est inconnu ou introuvable.
GET/v0/products/{product_id}/videos
Voir plus