Multimedia

Multimedia es el almacén de archivos de la cuenta: las imágenes y el video
que aparecen en unidades, propiedades y
sitios web.

Un archivo se sube una vez y se reutiliza. La misma foto puede ser la imagen
principal de una unidad, aparecer en su galería y ser el banner de un sitio, sin
que existan tres copias.

Qué se puede subir

Los archivos se organizan en carpetas — una etiqueta libre que uno elige,
útil en cuanto la biblioteca crece más allá de lo que cabe en una pantalla.

Un archivo puede asociarse a una propiedad, o quedarse a nivel de cuenta para
cosas que no son de una propiedad en particular.

Desde dónde se sirven

Las imágenes y el video son públicos por diseño — son material de marketing,
servido desde un CDN para que un sitio web cargue rápido desde donde sea.

Los documentos del huésped no son multimedia. Todo lo que cargue datos
personales — un documento de identidad, el resultado de una verificación — vive
en almacenamiento privado, en otra ruta, y nunca se sirve desde el CDN público.
Son dos almacenes separados a propósito, para que la pregunta "¿esto es seguro de
hacer público?" la responda a dónde fue a parar, y no el acordarse de marcar
una casilla.

Y nótese lo que no se guarda en absoluto: las fotografías tomadas durante la
verificación de identidad.
Esas se quedan con el proveedor de verificación y se traen mediante enlaces que
expiran, cuando recepción las pide.

Borrar

Un archivo puede estar referenciado desde varios lados, así que borrar uno puede
dejar a una unidad o a un sitio apuntando a algo que ya no está. Conviene revisar
dónde se usa un archivo antes de quitarlo — con un archivo del que se duda, lo
seguro es dejarlo.

En la API

• Merchant: POST /api/merchant/media (multipart), GET /api/merchant/media
  con filtros por tipo, carpeta y propiedad.
• Los campos de imagen de una unidad, y el logo de una propiedad, guardan el
  id de multimedia. Las respuestas traen además la url ya resuelta, así
  que un formulario puede renderizar lo que tiene sin una segunda vuelta — el id
  es lo que se envía de regreso, la url es lo que se muestra.

Relacionado

• Unidades — imagen principal, galería e imagen para SEO.
• Propiedades — el logo que ve un huésped en el check-in y en los correos.
• Sitios web y motor de reservas — logo, favicon y banner.