API · attachments

Operaciones de attachments del contrato OpenAPI que aceptan una clave de API.

Actualizado:

GET /bookings/{id}/attachments

—

Adjuntos vigentes del tenant activo y sus recursos autorizados; URLs relativas firmadas ≤300s también exigen la credencial vigente. Nunca storage_key, nombre del cliente ni URL externa. Viewer solo lee.

  • Autenticación: Clave de API o sesión del panel
  • Scopes: Ninguno

Parámetros

NombreEnObligatorioTipoDescripción
idpathSístring
limitqueryNointeger default 25
cursorqueryNostring

Respuestas

EstadoDescripción
200Adjuntos más recientes primero (object)
defaultError (RFC 9457) (Problem)

GET /bookings/{id}/attachments/{attachment_id}

Leer metadatos privados de una evidencia

Scope bookings:read para API keys; tenant y recurso autorizados, misma reserva, evidencia vigente no borrada. Devuelve una nueva URL firmada ligada al actor que también exige credencial vigente; la firma sola nunca autoriza. Sin storage_key ni contenido.

  • Autenticación: Clave de API o sesión del panel
  • Scopes: bookings:read

Parámetros

NombreEnObligatorioTipoDescripción
idpathSístring
attachment_idpathSístring (uuid)

Respuestas

EstadoDescripción
200Metadatos para mostrar una referencia UUID del formulario (Attachment)
404Error (RFC 9457) (Problem)
defaultError (RFC 9457) (Problem)

GET /bookings/{id}/attachments/{attachment_id}/download

—

Firma ligada al tenant, actor, adjunto y plazo; se revalida credencial/rol/recurso y retención. Attachment disposition, nosniff, no-store; no redirects ni URLs de terceros. La firma sola no autoriza.

  • Autenticación: Clave de API o sesión del panel
  • Scopes: Ninguno

Parámetros

NombreEnObligatorioTipoDescripción
idpathSístring
attachment_idpathSístring (uuid)
expiresquerySíinteger
signaturequerySístring

Respuestas

EstadoDescripción
200Blob verificado (string)
defaultError (RFC 9457) (Problem)

GET /bookings/{id}/location-events

—

Capturas puntuales vigentes; mismas restricciones de tenant y recurso de la reserva. No rastreo continuo. También figuran en timeline; nunca se incluyen coordenadas en audit ni stage-history.

  • Autenticación: Clave de API o sesión del panel
  • Scopes: Ninguno

Parámetros

NombreEnObligatorioTipoDescripción
idpathSístring
limitqueryNointeger default 25
cursorqueryNostring

Respuestas

EstadoDescripción
200Capturas más recientes primero (object)
defaultError (RFC 9457) (Problem)