API · feedback
Operaciones de feedback del contrato OpenAPI que aceptan una clave de API.
Actualizado:
GET /feedback/{kind}/{identifier}
Consultar evaluación
Tenant desde credencial. Owner configura/revoca; owner/manager consultan todas las entidades; staff solo tareas/recursos propios. Scopes config:read para GET settings, settings:write para PUT/DELETE y bookings:read para indicadores. API keys no leen comentarios privados. Una puntuación baja agrega la etiqueta revisar-evaluacion (requiere revisión en Hoy) y emite feedback_low para owner/manager; canales por defecto panel/push/Telegram/email, con preferencias y silencio. Promedio desde 3 respuestas como mínimo, escala 0-100; tendencia compara 30 días con los 30 anteriores.
- Autenticación: Clave de API
- Scopes:
config:read,settings:write,bookings:read
Parámetros
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
kind | path | Sí | string booking, service, customer, resource | |
identifier | path | Sí | string (uuid) |
Respuestas
| Estado | Descripción |
|---|---|
200 | Successful Response (FeedbackSummary) |
400 | Error (RFC 9457) (Problem) |
401 | Error (RFC 9457) (Problem) |
403 | Error (RFC 9457) (Problem) |
404 | Error (RFC 9457) (Problem) |
413 | Error (RFC 9457) (Problem) |
422 | Error (RFC 9457) (Problem) |
429 | Error (RFC 9457) (Problem) |
503 | Error (RFC 9457) (Problem) |
DELETE /feedback/booking/{identifier}
Revocar enlace de evaluación
Tenant desde credencial. Owner configura/revoca; owner/manager consultan todas las entidades; staff solo tareas/recursos propios. Scopes config:read para GET settings, settings:write para PUT/DELETE y bookings:read para indicadores. API keys no leen comentarios privados. Una puntuación baja agrega la etiqueta revisar-evaluacion (requiere revisión en Hoy) y emite feedback_low para owner/manager; canales por defecto panel/push/Telegram/email, con preferencias y silencio. Promedio desde 3 respuestas como mínimo, escala 0-100; tendencia compara 30 días con los 30 anteriores.
- Autenticación: Clave de API
- Scopes:
config:read,settings:write,bookings:read
Parámetros
| Nombre | En | Obligatorio | Tipo | Descripción |
|---|---|---|---|---|
identifier | path | Sí | string (uuid) |
Respuestas
| Estado | Descripción |
|---|---|
204 | Operación realizada |
400 | Error (RFC 9457) (Problem) |
401 | Error (RFC 9457) (Problem) |
403 | Error (RFC 9457) (Problem) |
404 | Error (RFC 9457) (Problem) |
413 | Error (RFC 9457) (Problem) |
422 | Error (RFC 9457) (Problem) |
429 | Error (RFC 9457) (Problem) |
503 | Error (RFC 9457) (Problem) |
GET /feedback/settings
Consultar evaluación
Tenant desde credencial. Owner configura/revoca; owner/manager consultan todas las entidades; staff solo tareas/recursos propios. Scopes config:read para GET settings, settings:write para PUT/DELETE y bookings:read para indicadores. API keys no leen comentarios privados. Una puntuación baja agrega la etiqueta revisar-evaluacion (requiere revisión en Hoy) y emite feedback_low para owner/manager; canales por defecto panel/push/Telegram/email, con preferencias y silencio. Promedio desde 3 respuestas como mínimo, escala 0-100; tendencia compara 30 días con los 30 anteriores.
- Autenticación: Clave de API
- Scopes:
config:read,settings:write,bookings:read
Respuestas
| Estado | Descripción |
|---|---|
200 | Successful Response (FeedbackSettings) |
400 | Error (RFC 9457) (Problem) |
401 | Error (RFC 9457) (Problem) |
403 | Error (RFC 9457) (Problem) |
404 | Error (RFC 9457) (Problem) |
413 | Error (RFC 9457) (Problem) |
422 | Error (RFC 9457) (Problem) |
429 | Error (RFC 9457) (Problem) |
503 | Error (RFC 9457) (Problem) |
PUT /feedback/settings
Configurar evaluaciones (owner)
Tenant desde credencial. Owner configura/revoca; owner/manager consultan todas las entidades; staff solo tareas/recursos propios. Scopes config:read para GET settings, settings:write para PUT/DELETE y bookings:read para indicadores. API keys no leen comentarios privados. Una puntuación baja agrega la etiqueta revisar-evaluacion (requiere revisión en Hoy) y emite feedback_low para owner/manager; canales por defecto panel/push/Telegram/email, con preferencias y silencio. Promedio desde 3 respuestas como mínimo, escala 0-100; tendencia compara 30 días con los 30 anteriores.
- Autenticación: Clave de API
- Scopes:
config:read,settings:write,bookings:read
Cuerpo de la solicitud (obligatorio)
application/json: FeedbackSettings
Respuestas
| Estado | Descripción |
|---|---|
200 | Successful Response (FeedbackSettings) |
400 | Error (RFC 9457) (Problem) |
401 | Error (RFC 9457) (Problem) |
403 | Error (RFC 9457) (Problem) |
404 | Error (RFC 9457) (Problem) |
413 | Error (RFC 9457) (Problem) |
422 | Error (RFC 9457) (Problem) |
429 | Error (RFC 9457) (Problem) |
503 | Error (RFC 9457) (Problem) |