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

NombreEnObligatorioTipoDescripción
kindpathSístring booking, service, customer, resource
identifierpathSístring (uuid)

Respuestas

EstadoDescripción
200Successful Response (FeedbackSummary)
400Error (RFC 9457) (Problem)
401Error (RFC 9457) (Problem)
403Error (RFC 9457) (Problem)
404Error (RFC 9457) (Problem)
413Error (RFC 9457) (Problem)
422Error (RFC 9457) (Problem)
429Error (RFC 9457) (Problem)
503Error (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

NombreEnObligatorioTipoDescripción
identifierpathSístring (uuid)

Respuestas

EstadoDescripción
204Operación realizada
400Error (RFC 9457) (Problem)
401Error (RFC 9457) (Problem)
403Error (RFC 9457) (Problem)
404Error (RFC 9457) (Problem)
413Error (RFC 9457) (Problem)
422Error (RFC 9457) (Problem)
429Error (RFC 9457) (Problem)
503Error (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

EstadoDescripción
200Successful Response (FeedbackSettings)
400Error (RFC 9457) (Problem)
401Error (RFC 9457) (Problem)
403Error (RFC 9457) (Problem)
404Error (RFC 9457) (Problem)
413Error (RFC 9457) (Problem)
422Error (RFC 9457) (Problem)
429Error (RFC 9457) (Problem)
503Error (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

EstadoDescripción
200Successful Response (FeedbackSettings)
400Error (RFC 9457) (Problem)
401Error (RFC 9457) (Problem)
403Error (RFC 9457) (Problem)
404Error (RFC 9457) (Problem)
413Error (RFC 9457) (Problem)
422Error (RFC 9457) (Problem)
429Error (RFC 9457) (Problem)
503Error (RFC 9457) (Problem)