Obtener archivo desde S3

GET 
/files/

Obtiene un archivo almacenado en Amazon S3.

Este endpoint permite recuperar archivos genéricos (PDF, imágenes, binarios) previamente subidos al sistema. Requiere autenticación mediante JWT y el nombre exacto del archivo a recuperar.

Casos de uso:

• Descargar documentos PDF como facturas o contratos
• Visualizar imágenes de perfil o documentos escaneados
• Recuperar archivos binarios específicos

Ejemplo:

GET /?file=factura_12345.pdf

Request

Responses

200

Archivo obtenido exitosamente desde S3.

El contenido devuelto varía según el tipo de archivo solicitado:

• PDF: application/pdf
• Imágenes: image/jpeg o image/png
• Otros tipos: application/octet-stream

Ejemplo de respuesta exitosa:

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="factura_12345.pdf"

[binary data]

404

El archivo solicitado no existe en S3.

Posibles causas:

• Nombre de archivo incorrecto
• El archivo fue eliminado
• El archivo nunca fue subido

Ejemplo de respuesta:

{
  "error": "File not found",
  "message": "El archivo solicitado no existe"
}

500

Error interno del servidor al intentar obtener el archivo.

Posibles causas:

• Problemas de conexión con S3
• Permisos insuficientes
• Error inesperado en el servidor

Ejemplo de respuesta:

{
  "error": "Internal Server Error",
  "message": "No se pudo recuperar el archivo"
}