Pular para o conteúdo principal
curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects?name=myfile&prefix=images&expire=30' \
  --header 'Authorization: SUA_API_KEY' \
  --form 'file=@./myphone.png'

{
    "status": "success",
    "response": {
        "id": "3155597145698959364/test_lxch4k7y-07ee.png",
        "name": "test",
        "size": 416230,
        "url": "https://public-blob.squarecloud.dev/3155597145698959364/test_lxch4k7y-07ee.png"
    }
}
​
Authorization
string
obrigatório
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
​
file
file
obrigatório
Use FormData. (multipart/form-data)
​
name
string
obrigatório
Uma string representando o nome do arquivo (sem extensão).
Deve obedecer ao padrão a-z, A-Z, 0-9 e _ (3 a 32 caracteres).
​
prefix
string
Uma string representando o prefixo do arquivo.
Deve obedecer ao padrão a a z, A a Z, 0 a 9 e _ (3 a 32 caracteres).
​
expire
number
Um número indicando o período de expiração do arquivo, variando de 1 a 365 dias.
​
security_hash
boolean
Defina como true se um hash de segurança for exigido.
​
auto_download
boolean
Defina como true se o arquivo deve ser marcado para download automático.

​
Limites e uploads simultâneos

O envio de arquivos exige um plano pago.
  • Planos Hobby e Standard são limitados a 1 upload por segundo.
  • Planos Pro e Enterprise não têm o limite por segundo — em vez disso, podem realizar até 4 uploads ao mesmo tempo.
Em todos os planos pagos, uma conta pode ter no máximo 4 uploads em andamento simultaneamente. Iniciar outro upload enquanto 4 ainda estão em execução retorna TOO_MANY_CONCURRENT_UPLOADS (429).
Por segurança, arquivos .html e .svg são sempre entregues como download (servidos como application/octet-stream) em vez de renderizados inline.

​
Resposta

​
status
string
Indica se a chamada foi bem-sucedida. “success” se bem-sucedida, “error” caso contrário.
​
response
object
curl --request POST \
  --url 'https://blob.squarecloud.app/v1/objects?name=myfile&prefix=images&expire=30' \
  --header 'Authorization: SUA_API_KEY' \
  --form 'file=@./myphone.png'

{
    "status": "success",
    "response": {
        "id": "3155597145698959364/test_lxch4k7y-07ee.png",
        "name": "test",
        "size": 416230,
        "url": "https://public-blob.squarecloud.dev/3155597145698959364/test_lxch4k7y-07ee.png"
    }
}

​
Solução de problemas

​
Relacionado ao Objeto

// O nome do objeto fornecido é inválido.
// Deve obedecer ao padrão a a z, A a Z, 0 a 9 e _.
{
    "status": "error",
    "code": "INVALID_OBJECT_NAME"
}

​
Relacionado ao Arquivo

O tamanho máximo de arquivo atualmente é 100MB. No futuro, planejamos aumentar para 10GB. Por enquanto, o limite é 100MB devido a restrições técnicas e de balanceamento.
// O arquivo fornecido é inválido.
{
    "status": "error",
    "code": "INVALID_FILE"
}