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.