Download de Arquivo

Este guia descreve como realizar o download de um arquivo armazenado na plataforma TucanoCloud utilizando a API. Você aprenderá a autenticar-se, configurar seu projeto e baixar arquivos de forma eficiente e segura.

Endpoint de Download

Para realizar o download de um arquivo, envie uma requisição HTTP GET para o seguinte endpoint, substituindo <key> pelo caminho completo do arquivo que deseja baixar:

1curl -X GET https://api.tucanocloud.com/v1/download/<key> -o arquivo-baixado.png

Detalhes da Rota

Método

GET

Endpoint

/api/download/[...key]

Descrição

Este endpoint permite o download de um arquivo específico armazenado na nuvem da TucanoCloud. O parâmetro <key> deve corresponder ao caminho completo do arquivo que você deseja baixar.

Parâmetros de Rota

• key (string, obrigatório) - O caminho completo do arquivo que será baixado. Por exemplo, `folder/subfolder/arquivo.png`.

Responses

200 OK

O arquivo foi encontrado e está sendo baixado.

1# Exemplo de download usando curl
2curl -X GET https://api.tucanocloud.com/v1/download/folder/subfolder/arquivo.png -o arquivo-baixado.png

404 Not Found

O arquivo solicitado não foi encontrado ou ocorreu um erro ao tentar acessá-lo.

1{
2  "error": "File not found or an error occurred."
3}

500 Internal Server Error

Ocorreu um erro interno ao tentar processar o download do arquivo.

1{
2  "error": "File not found or an error occurred."
3}

Passo a Passo para Download de Arquivo

Passo 1: Crie Sua Conta

Comece criando uma conta no painel da TucanoCloud. Após o cadastro, você terá acesso ao painel de controle, onde poderá gerenciar seus projetos e obter suas credenciais de API.

Passo 2: Configure Seu Projeto

No painel da TucanoCloud, crie um novo projeto. Cada projeto possui um identificador único (TUCANO_CLOUD_PROJECT_ID) e uma chave secreta (TUCANO_CLOUD_SECRET). Essas credenciais serão utilizadas para a autenticação nas requisições à API.

Passo 3: Realize o Download do Arquivo

Utilize o exemplo de comando curl acima para baixar o seu arquivo. Substitua <key> pelo caminho completo do arquivo que deseja baixar. Por exemplo:

1curl -X GET https://api.tucanocloud.com/v1/download/folder/subfolder/arquivo.png -o arquivo-baixado.png

Passo 4: Verifique o Download

Após executar o comando, verifique se o arquivo foi baixado corretamente na localização especificada (`-o arquivo-baixado.png`). Abra o arquivo para confirmar que o download foi bem-sucedido.