Synupv1
Crear clave
v1Recursos/Media/postSubir un archivo multimedia

Subir un archivo multimedia

Añade una nueva foto o video a la biblioteca de medios de la agencia a partir de una URL o un payload codificado en base64, opcionalmente limitado a una cuenta, cliente, ubicación o marca.

post/api/v1/media/upload
media:write
Cuerpo de la solicitud
urlstringopcional
Una URL públicamente accesible desde la que obtener el archivo. Proporcione esto o base64, no ambos.
base64stringopcional
El contenido del archivo en bruto, codificado en base64. Proporcione esto o url, no ambos.
mimestringopcional
Tipo MIME del archivo, p. ej. image/jpeg. Se infiere si se omite.
filenamestringopcional
Nombre de archivo original, usado para la visualización.
titlestringopcional
Un título legible para el archivo.
scopeTypestring (account | client | location | brand)opcional
A qué pertenece este archivo: account (toda la agencia), client, location o brand.
scopeIdstringopcional
El id del cliente o ubicación al que se limita el archivo, cuando scopeType es client o location.
folderIdstringopcional
Una carpeta de archivos existente en la que clasificar esta subida.
tagsarray of stringopcional
Etiquetas libres para asociar al archivo.
locationIdsarray of stringopcional
Ubicaciones adicionales a las que asociar este archivo, además de scopeId.
Respuesta
dataobjectopcional
assetobjectopcional
keystringopcional
Identificador compuesto del archivo, con el formato "<source>:<id>".
sourcestringopcional
Origen de este archivo (p. ej. una subida de OS frente a una fuente importada).
idstringopcional
El id del archivo dentro de su fuente.
titlestringopcional
El título del archivo.
filenamestringopcional
El nombre de archivo original del archivo.
mimestringopcional
El tipo MIME del archivo.
kindstringopcional
El tipo del archivo (foto o video).
sizeBytesnumberopcional
Tamaño del archivo en bytes, o null si se desconoce.
urlstringopcional
URL lista para usar con los bytes del archivo.
thumbnailUrlstringopcional
URL de una vista previa en miniatura, o null.
tagsarray of stringopcional
Etiquetas asociadas al archivo.
folderIdsarray of stringopcional
Carpetas de archivos a las que pertenece este archivo.
locationIdsarray of stringopcional
Todas las ubicaciones con las que está asociado este archivo.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/media/upload
Su clave de API
Cuerpo de la solicitud
{
  "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": []
    }
  }
}