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
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | Yes | string | |
limit | query | No | integer default 25 | |
cursor | query | No | string |
Responses
| Status | Description |
|---|---|
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.
- Authentication: API key or dashboard session
- Scopes:
bookings:read
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | Yes | string | |
attachment_id | path | Yes | string (uuid) |
Responses
| Status | Description |
|---|---|
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.
- Authentication: API key or dashboard session
- Scopes: None
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | Yes | string | |
attachment_id | path | Yes | string (uuid) | |
expires | query | Yes | integer | |
signature | query | Yes | string |
Responses
| Status | Description |
|---|---|
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.
- Authentication: API key or dashboard session
- Scopes: None
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | Yes | string | |
limit | query | No | integer default 25 | |
cursor | query | No | string |
Responses
| Status | Description |
|---|---|
200 | Capturas más recientes primero (object) |
default | Error (RFC 9457) (Problem) |