Blob
Pedir o link temporário
Um link curto que vence, para abrir ou baixar um arquivo público ou privado, sem a chave.
POST
curl
O link tem o nosso domínio e o nome do arquivo no fim, como
https://cdn.cubehost.dev/s/q7Rf2kLm9xA1.tm3a9k.9ig4z3Rd7w4dd7wb/relatorio.pdf. Vale 5 minutos por padrão (até 1 hora com expiresInSeconds) e só abre esse arquivo: depois do prazo, ou com qualquer parte do token mudada, responde 403. Ele pode ir para quem precisa do arquivo, como um usuário do seu bot, sem expor a chave.
A imagem (PNG, JPEG, GIF, WebP, AVIF, BMP) abre no navegador; o resto baixa como anexo, com o nome do arquivo. Com ?download=1 no fim do link, até a imagem baixa. HTML, SVG, XML e JavaScript sempre saem como binário: um link do Blob nunca vira página aberta.
Para um link que não vence, torne o arquivo público em Tornar público ou privado e use o
publicUrl.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.
Parâmetros de caminho
O ID do arquivo do Blob (26 caracteres), de Listar arquivos do Blob.
Pattern:
^[0-9A-HJKMNP-TV-Z]{26}$Exemplo:
"01JA3F7K2M9P4R6T8V0X1Z3B5D"
Corpo
application/json

