Synupv1
Schlüssel erstellen
v1Ressourcen/Media/postEin Medien-Asset hochladen

Ein Medien-Asset hochladen

Fügt der Medienbibliothek der Agentur ein neues Foto oder Video aus einer URL oder einem base64-kodierten Payload hinzu, optional beschränkt auf ein Konto, einen Kunden, einen Standort oder eine Marke.

post/api/v1/media/upload
media:write
Anfragetext
urlstringoptional
Eine öffentlich erreichbare URL, von der das Asset abgerufen wird. Entweder dies oder base64 angeben, nicht beides.
base64stringoptional
Der rohe Dateiinhalt, base64-kodiert. Entweder dies oder url angeben, nicht beides.
mimestringoptional
MIME-Typ der Datei, z. B. image/jpeg. Wird abgeleitet, wenn nicht angegeben.
filenamestringoptional
Ursprünglicher Dateiname, zur Anzeige verwendet.
titlestringoptional
Ein für Menschen lesbarer Titel für das Asset.
scopeTypestring (account | client | location | brand)optional
Wozu dieses Asset gehört: account (agenturweit), client, location oder brand.
scopeIdstringoptional
Die Kunden- oder Standort-ID, auf die das Asset beschränkt ist, wenn scopeType client oder location ist.
folderIdstringoptional
Ein vorhandener Asset-Ordner, in den dieser Upload eingeordnet werden soll.
tagsarray of stringoptional
Freie Tags, die dem Asset zugeordnet werden.
locationIdsarray of stringoptional
Weitere Standorte, die diesem Asset zugeordnet werden sollen, zusätzlich zu scopeId.
Antwort
dataobjectoptional
assetobjectoptional
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.
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.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/media/upload
Ihr API-Schlüssel
Anfragetext
{
  "data": {
    "asset": {
      "key": "upload:ghi789",
      "source": "upload",
      "id": "ghi789",
      "title": "New storefront photo",
      "filename": "new-storefront.jpg",
      "mime": "image/jpeg",
      "kind": "image",
      "sizeBytes": 398211,
      "url": "https://cdn.synup.com/media/ghi789.jpg",
      "thumbnailUrl": "https://cdn.synup.com/media/ghi789-thumb.jpg",
      "tags": [],
      "folderIds": [],
      "locationIds": []
    }
  }
}