curl. O armazenamento está incluído em todo plano: veja Blob Storage para planos, preços e perguntas frequentes.
URL base
Todo endpoint desta referência é relativo a:Autenticação
O Blob Storage aceita as mesmas chaves de API da API da Square Cloud, no headerAuthorization. A chave precisa do escopo blob:write para enviar e de blob:read para listar e baixar, e não pode ser restrita a aplicações específicas. Crie uma nas configurações de segurança da sua conta e guarde-a em uma variável de ambiente:
Enviar um arquivo
O Envio de Objeto recebe o arquivo comomultipart/form-data e o nome dele, sem extensão, na query:
url funciona na hora em um navegador ou em uma tag <img>. Guarde o id exatamente como vem, porque todas as outras rotas o recebem.
Uma única requisição aceita arquivos de 512 bytes a 100 MB. Arquivos maiores, até 10 GiB, passam pelo upload em partes ou pelo gateway S3.
Enviar um arquivo privado
Adicioneprivate=true e o arquivo fica sem URL pública (url é null):
Baixar um arquivo
Um arquivo público é baixado pelaurl dele. Para um privado, o Download de Objeto assina um link temporário que funciona sem credenciais e redireciona para ele, então o curl -L salva o arquivo:
<id> pelo id do upload. Adicione redirect=false para receber o link em JSON e repassá-lo a outra pessoa. Para links que você pode revogar ou proteger com senha, crie um link de compartilhamento.
Listar e excluir arquivos
A Lista de Objetos retorna os seus arquivos página por página:Quando algo falha
Os erros vêm como{ "status": "error", "code": "..." }. Os que você tem mais chance de encontrar primeiro:
Todos os códigos estão em Erros.
Próximos passos
SDK do Blob
Envie e gerencie arquivos pelo JavaScript, e o upload em partes feito automaticamente.
Compatibilidade com S3
Use aws-cli, boto3, rclone ou qualquer SDK da AWS.
Links e compartilhamento
Links temporários, links de compartilhamento e quando usar cada um.
Upload pelo navegador
Deixe visitantes enviarem arquivos sem expor a sua chave de API.