Pular para o conteúdo principal
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.
Precisa entregar o mesmo arquivo de novo depois do prazo? Peça outro link: cada pedido é rápido e fica na Atividade da conta.

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_…. 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.

Scopes

blob:read

Parâmetros de caminho

id
string
obrigatório

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
expiresInSeconds
integer
padrão:300

Quanto o link vale, em segundos.

Intervalo obrigatório: 60 <= x <= 3600

Resposta

O link e até quando ele vale.

url
string<uri>
obrigatório

O link completo (https://cdn.cubehost.dev/s/…/<nome>): abra ou baixe com um GET, sem a chave de API.

expiresAt
string<date-time>
obrigatório