Logo SOAR

Enviar Respostas da Avaliação

Descrição

Este endpoint permite enviar as respostas de uma avaliação em andamento. As respostas são processadas e armazenadas para posterior cálculo dos resultados.

Verbo

POST

URL Base

https://api.soargi.com

Endpoint

/assessment/answer

Cabeçalhos

Parâmetro Valor
Authorization Bearer Token
Content-Type application/json

Campos Esperados

Campo Tipo Obrigatório Descrição
assessment_id integer Sim ID da avaliação em andamento.
answers array Sim Array com as respostas das questões.
step string Sim Etapa da avaliação (ex: "p1", "p2").

Estrutura do Array de Respostas

Campo Tipo Obrigatório Descrição
question_id integer Sim ID da questão respondida.
answer string Sim Resposta fornecida pelo usuário.
response_time integer Não Tempo de resposta em segundos.

Corpo da Requisição

{
  "assessment_id": 123,
  "step": "p1",
  "answers": [
    {
      "question_id": 1,
      "answer": "palavra",
      "response_time": 5
    },
    {
      "question_id": 2,
      "answer": "tempo",
      "response_time": 3
    }
  ]
}

Sucesso - 200

{
  "status": "success",
  "message": "Answers submitted successfully.",
  "assessment_id": 123,
  "total_answers": 2
}

Erro - 400 (Campos obrigatórios)

{
  "status": 400,
  "error": 400,
  "messages": "assessment_id, answers and step are required."
}

Erro - 401 (Token inválido)

{
  "status": 401,
  "error": "Invalid or expired token."
}

Erro - 404 (Avaliação não encontrada)

{
  "status": 404,
  "error": "Assessment not found."
}

Códigos de Resposta

  • 200 - Respostas enviadas com sucesso
  • 400 - Campos obrigatórios não fornecidos
  • 401 - Token inválido ou expirado
  • 404 - Avaliação não encontrada

Observações

  • É necessário estar autenticado para acessar este endpoint.
  • As respostas são validadas antes de serem armazenadas.
  • O campo response_time é opcional mas recomendado para análise.
  • As respostas são associadas à avaliação específica através do assessment_id.
  • Após enviar as respostas, a avaliação pode ser processada para cálculo de resultados.