Synupv1
Criar chave
v1Recursos/Media/postEnviar um arquivo de mídia

Enviar um arquivo de mídia

Adiciona uma nova foto ou vídeo à biblioteca de mídia da agência a partir de uma URL ou payload codificado em base64, opcionalmente limitado a uma conta, cliente, local ou marca.

post/api/v1/media/upload
media:write
Corpo da solicitação
urlstringopcional
Uma URL publicamente acessível de onde buscar o arquivo. Informe isso ou base64, não ambos.
base64stringopcional
O conteúdo bruto do arquivo, codificado em base64. Informe isso ou url, não ambos.
mimestringopcional
Tipo MIME do arquivo, ex.: image/jpeg. Inferido quando omitido.
filenamestringopcional
Nome de arquivo original, usado para exibição.
titlestringopcional
Um título legível para o arquivo.
scopeTypestring (account | client | location | brand)opcional
A que este arquivo pertence: account (toda a agência), client, location ou brand.
scopeIdstringopcional
O id do cliente ou local ao qual o arquivo está limitado, quando scopeType é client ou location.
folderIdstringopcional
Uma pasta de arquivos existente na qual arquivar este envio.
tagsarray of stringopcional
Tags livres para associar ao arquivo.
locationIdsarray of stringopcional
Locais adicionais a associar a este arquivo, além do scopeId.
Resposta
dataobjectopcional
assetobjectopcional
keystringopcional
Identificador composto do arquivo, no formato "<source>:<id>".
sourcestringopcional
Origem deste arquivo (ex.: um envio do OS em vez de uma fonte importada).
idstringopcional
O id do arquivo dentro de sua fonte.
titlestringopcional
O título do arquivo.
filenamestringopcional
O nome de arquivo original do arquivo.
mimestringopcional
O tipo MIME do arquivo.
kindstringopcional
O tipo do arquivo (foto ou vídeo).
sizeBytesnumberopcional
Tamanho do arquivo em bytes, ou null se desconhecido.
urlstringopcional
URL pronta para uso com os bytes do arquivo.
thumbnailUrlstringopcional
URL de uma miniatura de pré-visualização, ou null.
tagsarray of stringopcional
Tags associadas ao arquivo.
folderIdsarray of stringopcional
Pastas de arquivos às quais este arquivo pertence.
locationIdsarray of stringopcional
Todos os locais associados a este arquivo.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/media/upload
Sua chave de API
Corpo da solicitação
{
  "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": []
    }
  }
}