API · attachments

attachments operations in the OpenAPI contract that accept an API key.

Updated:

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.

  • Authentication: API key or dashboard session
  • Scopes: None

Parameters

NameInRequiredTypeDescription
idpathYesstring
limitqueryNointeger default 25
cursorqueryNostring

Responses

StatusDescription
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.

  • Authentication: API key or dashboard session
  • Scopes: bookings:read

Parameters

NameInRequiredTypeDescription
idpathYesstring
attachment_idpathYesstring (uuid)

Responses

StatusDescription
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.

  • Authentication: API key or dashboard session
  • Scopes: None

Parameters

NameInRequiredTypeDescription
idpathYesstring
attachment_idpathYesstring (uuid)
expiresqueryYesinteger
signaturequeryYesstring

Responses

StatusDescription
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.

  • Authentication: API key or dashboard session
  • Scopes: None

Parameters

NameInRequiredTypeDescription
idpathYesstring
limitqueryNointeger default 25
cursorqueryNostring

Responses

StatusDescription
200Capturas más recientes primero (object)
defaultError (RFC 9457) (Problem)