Blob
Pedir o envio de um arquivo
Reserve o envio e receba um link de 15 minutos (ou o envio em partes) para mandar o arquivo direto ao armazenamento.
POST
curl
O envio tem três passos:
1
Peça o envio
Mande o nome (
path), o tamanho exato em bytes (sizeBytes, até o teto do plano), o tipo (contentType) e, se quiser um link fixo, visibility: "public". A Cube confere o limite, a cota do plano e a regra da pasta e devolve o link em upload.url.2
Mande o arquivo no link
PUT no upload.url com o Content-Type de upload.headers e o arquivo no corpo. O link só aceita esse tamanho e esse tipo, e o arquivo não passa pelo servidor dos projetos.3
Confirme
Chame Confirmar o envio. Só então o arquivo aparece na lista; o público já vem com o
publicUrl, que não vence.Opções do envio
O Blob é dos planos pagos (Block 5 GB, Stack 10 GB, Tower 25 GB, Fortress 50 GB, Monolith 100 GB, Empresas de 200 GB a 6.400 GB), com até 1/5 da cota por arquivo, no máximo 4 GB (Block 1 GB, Stack 2 GB, do Tower em diante 4 GB). O arquivo sobe do jeito que você mandar (quem envia pelo painel tem as fotos reduzidas no navegador antes). Um envio que você desistir de fazer se cancela com Apagar; o tamanho dele segue reservado até o link de envio vencer (15 minutos). O arquivo que chega pelo link e não é confirmado em 10 minutos é removido.
Erros comuns
Todos os códigos, com o formato do erro, em Códigos de erro.
Autorizações
Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_…. Cada rota pede uma permissão da chave (o escopo no security da rota, como files:write); sem ela, 403 insufficient_scope com o requiredScope. Veja Chaves de API.
Corpo
application/json

