API · feedback
feedback operations in the OpenAPI contract that accept an API key.
Updated:
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.
- Authentication: API key
- Scopes:
config:read,settings:write,bookings:read
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
kind | path | Yes | string booking, service, customer, resource | |
identifier | path | Yes | string (uuid) |
Responses
| Status | Description |
|---|---|
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.
- Authentication: API key
- Scopes:
config:read,settings:write,bookings:read
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
identifier | path | Yes | string (uuid) |
Responses
| Status | Description |
|---|---|
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.
- Authentication: API key
- Scopes:
config:read,settings:write,bookings:read
Responses
| Status | Description |
|---|---|
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.
- Authentication: API key
- Scopes:
config:read,settings:write,bookings:read
Request body (required)
application/json: FeedbackSettings
Responses
| Status | Description |
|---|---|
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) |