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.