API · attachments
Operações de attachments do contrato OpenAPI que aceitam uma chave de API.
Atualizado:
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.
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
id | path | Sim | string | |
limit | query | Não | integer default 25 | |
cursor | query | Não | string |
Respostas
| Status | Descrição |
|---|---|
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.
- Autenticação: Chave de API ou sessão do painel
- Escopos:
bookings:read
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
id | path | Sim | string | |
attachment_id | path | Sim | string (uuid) |
Respostas
| Status | Descrição |
|---|---|
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.
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
id | path | Sim | string | |
attachment_id | path | Sim | string (uuid) | |
expires | query | Sim | integer | |
signature | query | Sim | string |
Respostas
| Status | Descrição |
|---|---|
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.
- Autenticação: Chave de API ou sessão do painel
- Escopos: Nenhum
Parâmetros
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
id | path | Sim | string | |
limit | query | Não | integer default 25 | |
cursor | query | Não | string |
Respostas
| Status | Descrição |
|---|---|
200 | Capturas más recientes primero (object) |
default | Error (RFC 9457) (Problem) |