Descrição

Este endpoint calcula o resultado da avaliação P1 (Primeira Parte) baseado nas respostas fornecidas. O cálculo é realizado usando algoritmos específicos para determinar o nível de proficiência do usuário.

Cabeçalhos

Campos Esperados

Corpo da Requisição

{
  "assessment_id": 123,
  "language_id": 2,
  "answers": [
    {
      "question_id": 1,
      "answer": "palavra",
      "correct_answer": "palavra",
      "is_correct": true
    },
    {
      "question_id": 2,
      "answer": "tempo",
      "correct_answer": "tempo",
      "is_correct": true
    }
  ]
}

Sucesso - 200

{
  "status": "success",
  "message": "P1 calculation completed successfully.",
  "assessment_id": 123,
  "results": {
    "total_questions": 20,
    "correct_answers": 18,
    "incorrect_answers": 2,
    "accuracy_percentage": 90.0,
    "proficiency_level": "Advanced",
    "score": 85.5,
    "time_taken": 300,
    "language": "Portuguese"
  },
  "detailed_results": {
    "vocabulary_score": 92.0,
    "grammar_score": 88.0,
    "comprehension_score": 85.0
  }
}

Erro - 400 (Campos obrigatórios)

{
  "status": 400,
  "error": 400,
  "messages": "assessment_id, answers and language_id 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 - Cálculo P1 concluído com sucesso
• 400 - Campos obrigatórios não fornecidos
• 401 - Token inválido ou expirado
• 404 - Avaliação não encontrada

Detalhes dos Resultados

• total_questions: Número total de questões da avaliação P1
• correct_answers: Quantidade de respostas corretas
• accuracy_percentage: Percentual de acerto geral
• proficiency_level: Nível de proficiência calculado
• score: Pontuação numérica (0-100)
• vocabulary_score: Pontuação específica em vocabulário
• grammar_score: Pontuação específica em gramática
• comprehension_score: Pontuação específica em compreensão

Observações

• É necessário estar autenticado para acessar este endpoint.
• O cálculo P1 é específico para a primeira parte da avaliação.
• Os resultados são armazenados e podem ser consultados posteriormente.
• O nível de proficiência é calculado automaticamente baseado na pontuação.
• Este endpoint atualiza o status da avaliação para "completed" após o cálculo.