Upload de Arquivo Único

Este guia descreve como realizar o upload de um único arquivo para a plataforma TucanoCloud utilizando a API. Você aprenderá a autenticar-se, configurar seu projeto e enviar o arquivo de forma segura.

Endpoint de Upload

Para realizar o upload de um arquivo, envie uma requisição HTTP POST para o seguinte endpoint:

upload.sh

1curl -X POST https://api.tucanocloud.com/v1/upload \
2  -F "secret_key=SEU_SECRET_KEY" \
3  -F "project_id=SEU_PROJECT_ID" \
4  -F "file=@/caminho/para/seu/arquivo.png"

Detalhes da Rota

Método

POST

Endpoint

/api/upload

Descrição

Este endpoint permite o upload de um arquivo 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 o arquivo pertence.
file (File, obrigatório) - O arquivo que será enviado.

Responses

200 OK

O arquivo foi enviado com sucesso.

response-200.json

1{
2  "message": "File uploaded",
3  "fileName": "arquivo.png",
4  "url": "https://cloud.tucano.app/api/d/seu-project-id/arquivo.png"
5}

400 Bad Request

Nenhum arquivo foi enviado.

response-400.json

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

500 Internal Server Error

Ocorreu um erro interno ao tentar enviar o arquivo.

response-500.json

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

Passo a Passo para Upload

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 do Arquivo

Utilize o exemplo de comando curl acima para enviar seu arquivo. Certifique-se de substituir SEU_SECRET_KEY e SEU_PROJECT_ID pelos valores correspondentes ao seu projeto.

Passo 4: Verifique o Upload

Após enviar o arquivo, verifique a resposta da API para confirmar que o upload foi bem-sucedido. Você receberá uma URL para acessar o arquivo enviado.