Upload de Múltiplos Arquivos

Este guia explica como realizar o upload de múltiplos arquivos para a plataforma TucanoCloud utilizando a API. Você aprenderá a autenticar-se, configurar seu projeto e enviar vários arquivos de forma eficiente e segura.

Endpoint de Upload Múltiplo

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

upload-multiple.sh

1curl -X POST https://api.tucanocloud.com/v1/upload/multiple \
2  -F "secret_key=SEU_SECRET_KEY" \
3  -F "project_id=SEU_PROJECT_ID" \
4  -F "files[]=@/caminho/para/seu/arquivo1.png" \
5  -F "files[]=@/caminho/para/seu/arquivo2.png"

Detalhes da Rota

Método

POST

Endpoint

/api/upload/multiple

Descrição

Este endpoint permite o upload de múltiplos arquivos para o armazenamento em nuvem da TucanoCloud. É 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, obrigatório) - Um array de arquivos que serão enviados.

Responses

200 OK

Os arquivos foram enviados com sucesso.

response-200.json

1{
2  "message": "Files uploaded",
3  "files": [
4    { "name": "arquivo1.png", "url": "https://s3.amazonaws.com/seu-bucket/arquivo1.png" },
5    { "name": "arquivo2.png", "url": "https://s3.amazonaws.com/seu-bucket/arquivo2.png" }
6  ]
7}

400 Bad Request

Nenhum arquivo foi enviado.

response-400.json

1{
2  "message": "No files uploaded"
3}

500 Internal Server Error

Ocorreu um erro interno ao tentar enviar os arquivos.

response-500.json

1{
2  "message": "Error uploading files"
3}

Passo a Passo para Upload de Múltiplos 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 Upload dos Arquivos

Utilize o exemplo de comando curl acima para enviar seus arquivos. Certifique-se de substituir SEU_SECRET_KEY e SEU_PROJECT_ID pelos valores correspondentes ao seu projeto. Adicione quantos arquivos forem necessários utilizando a sintaxe files[]=@/caminho/para/seu/arquivo.

Passo 4: Verifique os Uploads

Após enviar os arquivos, verifique a resposta da API para confirmar que todos os uploads foram bem-sucedidos. Você receberá URLs para acessar cada um dos arquivos enviados.