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
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
id | path | Sí | string | |
limit | query | No | integer default 25 | |
cursor | query | No | string |
Respuestas
| Estado | Descripción |
|---|---|
200 | Adjuntos más recientes primero (object) |
default | Error (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
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
id | path | Sí | string | |
attachment_id | path | Sí | string (uuid) |
Respuestas
| Estado | Descripción |
|---|---|
200 | Metadatos para mostrar una referencia UUID del formulario (Attachment) |
404 | Error (RFC 9457) (Problem) |
default | Error (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
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
id | path | Sí | string | |
attachment_id | path | Sí | string (uuid) | |
expires | query | Sí | integer | |
signature | query | Sí | string |
Respuestas
| Estado | Descripción |
|---|---|
200 | Blob verificado (string) |
default | Error (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
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
id | path | Sí | string | |
limit | query | No | integer default 25 | |
cursor | query | No | string |
Respuestas
| Estado | Descripción |
|---|---|
200 | Capturas más recientes primero (object) |
default | Error (RFC 9457) (Problem) |