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

NameInRequiredTypeDescription
kindpathYesstring booking, service, customer, resource
identifierpathYesstring (uuid)

Responses

StatusDescription
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.

  • Authentication: API key
  • Scopes: config:read, settings:write, bookings:read

Parameters

NameInRequiredTypeDescription
identifierpathYesstring (uuid)

Responses

StatusDescription
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.

  • Authentication: API key
  • Scopes: config:read, settings:write, bookings:read

Responses

StatusDescription
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.

  • Authentication: API key
  • Scopes: config:read, settings:write, bookings:read

Request body (required)

  • application/json: FeedbackSettings

Responses

StatusDescription
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)