Synupv1
Créer une clé
v1Ressources/Media/getObtenir les médias de l'établissement

Obtenir les médias de l'établissement

Renvoie le logo, les photos et les vidéos disponibles pour un établissement, regroupés par catégorie.

get/api/v1/media
media:read
Paramètres de requête
locationIdstringobligatoire
L'établissement à consulter. Obligatoire.
Réponse
dataobjectfacultatif
locationIdstringfacultatif
L'établissement auquel appartiennent ces médias.
logoUrlstringfacultatif
URL du logo de l'établissement, ou null.
mediaByCategoryobjectfacultatif
Éléments multimédias regroupés par catégorie (par ex. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Chaque élément possède une url et, éventuellement, un label, un kind (PHOTO ou VIDEO), une source, un indicateur starred et un assetKey.
photosSummaryobjectfacultatif
Comptages agrégés de photos.
totalnumberfacultatif
Nombre total de photos, ou null.
byCategoryarray of objectfacultatif
Nombre de photos par catégorie.
categorystringfacultatif
countnumberfacultatif
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/media
Votre clé API
locationId *
{
  "data": {
    "locationId": "loc_456",
    "logoUrl": "https://cdn.synup.com/logos/loc_456.png",
    "mediaByCategory": {
      "EXTERIOR": [
        {
          "url": "https://cdn.synup.com/media/1.jpg",
          "kind": "PHOTO",
          "source": "user_upload",
          "starred": true
        }
      ]
    },
    "photosSummary": {
      "total": 12,
      "byCategory": [
        {
          "category": "EXTERIOR",
          "count": 4
        }
      ]
    }
  }
}