Logo SOAR

Atualizar Feedback da Avaliação

Descrição

Este endpoint permite atualizar o feedback de uma avaliação. É usado por practitioners e administradores para fornecer comentários, observações ou recomendações sobre os resultados da avaliação.

Verbo

PUT

Endpoint

/assessment/update-feedback/{assessmentId}

Headers

Authorization: Bearer {JWT_TOKEN}
Content-Type: application/json

Parâmetros de URL

assessmentId (integer) Obrigatório ID da avaliação a ser atualizada

Campos Obrigatórios

feedback (string) Obrigatório Texto do feedback a ser adicionado

Campos Opcionais

feedback_type (string) Opcional Tipo de feedback (ex: "general", "recommendation", "observation")
is_public (boolean) Opcional Se o feedback é visível para o usuário (padrão: true)

Exemplo de URL

/assessment/update-feedback/123

Exemplo de Request Body

{
  "feedback": "Excelente desempenho na avaliação. Recomendo focar no desenvolvimento de habilidades de liderança.",
  "feedback_type": "recommendation",
  "is_public": true
}

Resposta de Sucesso (200)

{
  "success": true,
  "message": "Feedback updated successfully.",
  "data": {
    "assessment_id": 123,
    "feedback": "Excelente desempenho na avaliação. Recomendo focar no desenvolvimento de habilidades de liderança.",
    "feedback_type": "recommendation",
    "is_public": true,
    "updated_by": "practitioner@exemplo.com",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Possíveis Erros

400 Bad Request

Dados inválidos ou campos obrigatórios ausentes

401 Unauthorized

Token JWT inválido ou expirado

403 Forbidden

Usuário não tem permissão para atualizar esta avaliação

404 Not Found

Avaliação não encontrada

Observações

  • Este endpoint requer autenticação JWT válida
  • Apenas practitioners responsáveis, master practitioners ou administradores podem adicionar feedback
  • O feedback pode ser público (visível para o usuário) ou privado (apenas para practitioners)
  • Múltiplos feedbacks podem ser adicionados à mesma avaliação
  • O histórico de feedback é mantido para auditoria
  • Feedback público pode ser visualizado pelo usuário na interface