Saltar al contenido principal

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 /images con query file.
  • El controlador combina body, query y params; para esta ruta se espera query.file.
  • Si file no llega, el backend intenta resolver - en storage y responde error.
  • El contenido se transmite por streaming y expone Content-Type, Content-Length y Content-disposition.

Autenticación

No requiere autenticación (security: []).

Request

Responses

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