Skip to main content
POST
curl
O envio tem três passos:
1

Peça o envio

Mande o nome (path), o tamanho exato em bytes (sizeBytes) e o tipo (contentType). A Cube confere a cota do plano 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.
Não mande a chave de API no PUT: o link já traz a autorização, e ele é só para esse arquivo.
O Blob é dos planos pagos (Block 5 GB, Stack 10 GB, Tower 25 GB, Fortress 50 GB, Monolith 100 GB), com até 4 GB por arquivo. 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

Authorization
string
header
obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Corpo

application/json
path
string
obrigatório

O nome, com pastas por /: até 1024 bytes, sem / no começo ou no fim, sem pasta vazia, . ou .., sem \.

sizeBytes
integer
obrigatório

O tamanho exato do arquivo: o link só aceita esse tamanho.

Intervalo obrigatório: 0 <= x <= 4294967296
contentType
string

O tipo (image/png), sem parâmetros; padrão application/octet-stream. O link só aceita esse tipo.

Resposta

O envio foi reservado: mande o arquivo no link e confirme.

object
object
obrigatório
upload
object
obrigatório