Retrieve file from S3
GET/truckers/files/
Obtém um arquivo armazenado no Amazon S3.
Este endpoint permite recuperar arquivos genéricos (PDF, imagens, binários) previamente enviados ao sistema. Requer autenticação via JWT e o nome exato do arquivo a ser recuperado.
Casos de uso:
- Baixar documentos PDF como faturas ou contratos
- Visualizar imagens de perfil ou documentos digitalizados
- Recuperar arquivos binários específicos
Exemplo:
GET /?file=fatura_12345.pdf
Request
Responses
- 200
- 404
- 500
Arquivo obtido com sucesso do S3.
O conteúdo retornado varia de acordo com o tipo de arquivo solicitado:
- PDF: application/pdf
- Imagens: image/jpeg ou image/png
- Outros tipos: application/octet-stream
Exemplo de resposta bem-sucedida:
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=fatura_12345.pdf
[dados binários]
Response Headers
O arquivo solicitado não existe no S3.
Possíveis causas:
- Nome do arquivo incorreto
- O arquivo foi excluído
- O arquivo nunca foi enviado
Exemplo de resposta:
{
error: File not found,
message: O arquivo solicitado não existe
}
Response Headers
Erro interno do servidor ao tentar obter o arquivo.
Possíveis causas:
- Problemas de conexão com o S3
- Permissões insuficientes
- Erro inesperado no servidor
Exemplo de resposta:
{
error: Internal Server Error,
message: Não foi possível recuperar o arquivo
}