Synupv1
Schlüssel erstellen
v1Ressourcen/Daten/getAssets auflisten

Assets auflisten

Liefert einen paginierten Ausschnitt des einheitlichen Asset-Katalogs, neueste zuerst — Uploads, KI-generierte Bilder, synchronisierte Medienbibliotheks-Assets, aus GBP importierte Fotos und nutzergenerierte (UGC) Medien, zu einem Feed zusammengeführt.

get/api/v1/assets
media:read
Query-Parameter
sourcestring (all | upload | gmb | generated | discovered | ugc)optional
Auf einen Quell-Tab eingrenzen: all (Standard), upload, gmb, generated, discovered oder ugc.
typestringoptional
Auf eine Asset-Art eingrenzen, z. B. image oder video.
folderIdstringoptional
Auf Assets in diesem Ordner eingrenzen.
tagstringoptional
Auf Assets mit diesem Tag-Namen eingrenzen.
locationIdstringoptional
Auf Assets eingrenzen, die diesem Standort zugewiesen sind. Nachschlagen mit GET /api/v1/locations.
clientIdstringoptional
Der Client, auf den die Ergebnisse eingegrenzt werden. Erforderlich, wenn dieser Schlüssel auf bestimmte Clients beschränkt ist und keine locationId angegeben wird. Nachschlagen mit GET /api/v1/clients.
qstringoptional
Suche nach Titel oder Dateiname.
cursorstringoptional
Paginierungs-Cursor aus dem nextCursor einer vorherigen Antwort.
limitnumberoptional
Maximale Anzahl zurückgegebener Elemente. Standard 60, maximal 200.
statusstring (needs_review | spam | ok | skipped)optional
Moderationsstatus-Filter — gilt nur, wenn source ugc ist: needs_review, spam, ok oder skipped.
Antwort
dataobjectoptional
itemsarray of objectoptional
Die Seite mit Assets.
keystringoptional
Zusammengesetzte Kennung für das Asset, im Format „<source>:<id>“.
sourcestringoptional
Herkunft dieses Assets (z. B. ein OS-Upload gegenüber einer importierten Quelle).
idstringoptional
Die ID des Assets innerhalb seiner Quelle.
titlestringoptional
Der Titel des Assets.
filenamestringoptional
Der ursprüngliche Dateiname des Assets.
mimestringoptional
Der MIME-Typ des Assets.
kindstringoptional
Die Art des Assets (Foto oder Video).
sizeBytesnumberoptional
Dateigröße in Bytes, oder null, wenn unbekannt.
urlstringoptional
Sofort nutzbare URL für die Bytes des Assets.
thumbnailUrlstringoptional
URL einer Vorschau-Miniaturansicht, oder null.
tagsarray of stringoptional
Dem Asset zugeordnete Tags.
folderIdsarray of stringoptional
Asset-Ordner, zu denen dieses Asset gehört.
locationIdsarray of stringoptional
Jeder Standort, dem dieses Asset zugeordnet ist.
nextCursorstringoptional
Beim nächsten Aufruf als cursor übergeben, um die folgende Seite zu laden. Null, wenn keine weiteren vorhanden sind.
countsobjectoptional
Gesamtsummen pro Tab (all/upload/gmb/generated/discovered/ugc), unabhängig von den aktiven Filtern.
Fehler
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/assets
Ihr API-Schlüssel
source
type
folderId
tag
locationId
clientId
q
cursor
limit
status
{
  "data": {
    "items": [
      {
        "key": "upload:abc123",
        "source": "upload",
        "id": "abc123",
        "title": "Storefront photo",
        "filename": "storefront.jpg",
        "mime": "image/jpeg",
        "kind": "image",
        "sizeBytes": 482913,
        "url": "https://cdn.synup.com/media/abc123.jpg",
        "thumbnailUrl": "https://cdn.synup.com/media/abc123-thumb.jpg",
        "tags": [
          "VIP"
        ],
        "folderIds": [
          "folder_1"
        ],
        "locationIds": [
          "loc_456"
        ]
      }
    ],
    "nextCursor": null,
    "counts": {
      "all": 1,
      "upload": 1,
      "gmb": 0,
      "generated": 0,
      "discovered": 0,
      "ugc": 0
    }
  }
}