API · feedback

Operações de feedback do contrato OpenAPI que aceitam uma chave de API.

Atualizado:

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.

  • Autenticação: Chave de API
  • Escopos: config:read, settings:write, bookings:read

Parâmetros

NomeEmObrigatórioTipoDescrição
kindpathSimstring booking, service, customer, resource
identifierpathSimstring (uuid)

Respostas

StatusDescrição
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.

  • Autenticação: Chave de API
  • Escopos: config:read, settings:write, bookings:read

Parâmetros

NomeEmObrigatórioTipoDescrição
identifierpathSimstring (uuid)

Respostas

StatusDescrição
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.

  • Autenticação: Chave de API
  • Escopos: config:read, settings:write, bookings:read

Respostas

StatusDescrição
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.

  • Autenticação: Chave de API
  • Escopos: config:read, settings:write, bookings:read

Corpo da solicitação (obrigatório)

  • application/json: FeedbackSettings

Respostas

StatusDescrição
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)