Get image by param query
GET/images
Propósito
Servir un recurso binario almacenado en storage usando la clave enviada por query string.
Objetivo
Facilitar la carga de imágenes o adjuntos en clientes que no construyen rutas con parámetro path.
Casos de uso
- Renderizar imágenes desde una URL tipo
/images?file=.... - Reutilizar la misma clave de archivo en distintos módulos sin cambiar el endpoint.
- Integraciones legacy que envían el identificador por query param.
Detalles técnicos
- Endpoint real en código:
GET /imagescon queryfile. - El controlador combina
body,queryyparams; para esta ruta se esperaquery.file. - Si
fileno llega, el backend intenta resolver-en storage y responde error. - El contenido se transmite por streaming y expone
Content-Type,Content-LengthyContent-disposition.
Autenticación
No requiere autenticación (security: []).
Request
Responses
- 200
- 404
- 500
Recurso servido exitosamente
Response Headers
Content-Type
Tipo MIME real del archivo servido desde storage
Content-Disposition
Header de descarga con el nombre generado por backend
Content-Length
Tamaño del archivo en bytes
Archivo no encontrado en storage
Response Headers
Error interno del servidor