Synupv1
Schlüssel erstellen
v1Ressourcen/Media/getStandort-Medien abrufen

Standort-Medien abrufen

Liefert Logo, Fotos und Videos, die für einen Standort hinterlegt sind, gruppiert nach Kategorie.

get/api/v1/media
media:read
Query-Parameter
locationIdstringerforderlich
Der abzurufende Standort. Erforderlich.
Antwort
dataobjectoptional
locationIdstringoptional
Der Standort, zu dem diese Medien gehören.
logoUrlstringoptional
URL des Logos des Standorts, oder null.
mediaByCategoryobjectoptional
Medienelemente gruppiert nach Kategorie (z. B. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Jedes Element hat eine url und optional ein label, ein kind (PHOTO oder VIDEO), eine source, ein starred-Flag und einen assetKey.
photosSummaryobjectoptional
Zusammengefasste Fotoanzahlen.
totalnumberoptional
Gesamtzahl der Fotos, oder null.
byCategoryarray of objectoptional
Fotoanzahl je Kategorie.
categorystringoptional
countnumberoptional
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/media
Ihr API-Schlüssel
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
        }
      ]
    }
  }
}