Download de Vários Arquivos (ZIP)

Este guia explica como realizar o download de múltiplos arquivos armazenados na plataforma TucanoCloud, compactando-os em um único arquivo ZIP. Você aprenderá a autenticar-se, verificar a existência dos arquivos e baixar o arquivo compactado de forma eficiente e segura.

Endpoint de Download de Vários Arquivos

Para realizar o download de múltiplos arquivos, envie uma requisição HTTP POST para o seguinte endpoint:

1curl -X POST https://api.tucanocloud.com/v1/download/multiple-zip \
2  -H "Content-Type: application/json" \
3  -d '{
4    "secret_key": "SEU_SECRET_KEY",
5    "project_id": "SEU_PROJECT_ID",
6    "files": [
7      "caminho/para/arquivo1.png",
8      "caminho/para/arquivo2.png"
9    ]
10  }' -o arquivos-batch.zip

Detalhes da Rota

Método

POST

Endpoint

/api/download/multiple-zip

Descrição

Este endpoint permite o download de múltiplos arquivos armazenados na nuvem da TucanoCloud, compactando-os em um único arquivo ZIP. É necessário autenticar-se utilizando a chave secreta do projeto e o identificador do projeto.

Parâmetros

• secret_key (string, obrigatório) - A chave secreta utilizada para autenticação.
• project_id (string, obrigatório) - O ID do projeto ao qual os arquivos pertencem.
• files (Array<string>, obrigatório) - Uma lista de caminhos completos dos arquivos que serão baixados. Por exemplo: "folder/subfolder/arquivo1.png".

Body da Requisição

1{
2  "secret_key": "SEU_SECRET_KEY",
3  "project_id": "SEU_PROJECT_ID",
4  "files": [
5    "folder/subfolder/arquivo1.png",
6    "folder/subfolder/arquivo2.png"
7  ]
8}

Responses

200 OK

Os arquivos foram encontrados, compactados e o arquivo ZIP foi retornado com sucesso.

1# Exemplo de download usando curl
2curl -X POST https://api.tucanocloud.com/v1/download/multiple-zip \
3  -H "Content-Type: application/json" \
4  -d '{
5    "secret_key": "SEU_SECRET_KEY",
6    "project_id": "SEU_PROJECT_ID",
7    "files": [
8      "folder/subfolder/arquivo1.png",
9      "folder/subfolder/arquivo2.png"
10    ]
11  }' -o arquivos-batch.zip

400 Bad Request

Os parâmetros fornecidos estão incorretos ou faltando.

1{
2  "message": "Invalid parameters or missing required fields."
3}

404 Not Found

Um ou mais arquivos solicitados não foram encontrados.

1{
2  "message": "One or more files not found."
3}

500 Internal Server Error

Ocorreu um erro interno ao tentar processar o download e a compactação dos arquivos.

1{
2  "message": "Error processing the download request."
3}

Passo a Passo para Download de Vários Arquivos

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 dos Arquivos

Utilize o exemplo de comando curl acima para enviar uma requisição de download. Certifique-se de substituir SEU_SECRET_KEY e SEU_PROJECT_ID pelos valores correspondentes ao seu projeto. Liste todos os arquivos que deseja baixar no array files.

Passo 4: Verifique o Download

Após executar o comando, verifique se o arquivo ZIP foi baixado corretamente na localização especificada (`-o arquivos-batch.zip`). Abra o arquivo ZIP para confirmar que todos os arquivos desejados estão presentes.