Cálculo do Relatório P1 (Guest)
Descrição
Permite calcular o relatório P1 de uma avaliação para um usuário Guest autenticado via token JWT. O cálculo é feito a partir do assessment_id e language_id informados.
É obrigatório enviar o token JWT de guest no header Authorization.
Verbo
POST
URL Base
https://api.soargi.com
Endpoint
/guest/calculate/p1
Cabeçalhos
Parâmetro | Valor |
---|---|
Content-Type | application/json |
Authorization | Bearer {token_guest} |
Esta rota exige autenticação via token JWT de convidado. O token é obtido ao validar o OTP do evento.
Campos Esperados
Campo | Tipo | Obrigatório | Descrição |
---|---|---|---|
assessment_id | integer | Sim | ID da avaliação a ser calculada. |
language_id | integer | Sim | ID do idioma para o cálculo. |
Corpo da Requisição
{
"assessment_id": 123,
"language_id": 1
}
Sucesso - 200 (OK)
{
"status": "success",
"result": {
/* ...resultado do cálculo... */
}
}
Erro - 400 (Campos obrigatórios)
{
"status": 400,
"messages": {
"error": "assessment_id and language_id are required."
}
}
Erro - 401 (Token ausente ou inválido)
{
"status": 401,
"messages": {
"error": "Token missing or invalid."
}
}
Erro - 500 (Erro interno)
{
"status": 500,
"messages": {
"error": "Error calculating assessment P1: ..."
}
}
Códigos de Resposta
- 200 - Cálculo realizado com sucesso
- 400 - Campos obrigatórios ausentes
- 401 - Token ausente ou inválido
- 500 - Erro interno ao calcular o relatório
Observações
- Atenção: Esta rota exige autenticação via token JWT de convidado (enviado no header Authorization).
- Os campos assessment_id e language_id são obrigatórios.
- O endpoint retorna erro caso algum campo obrigatório não seja informado ou se o token for inválido/expirado.