Logo SOAR

Listar Avaliações

Descrição

Retorna uma lista de todas as avaliações do sistema, com informações detalhadas incluindo usuário, practitioner, tipo de avaliação, status e organizações. Os dados são filtrados de acordo com o role do usuário autenticado.

Verbo

GET

URL Base

https://api.soargi.com

Endpoint

/assessment/list

Cabeçalhos

Parâmetro Valor
Authorization Bearer Token

Parâmetros de Consulta

Parâmetro Tipo Obrigatório Descrição
search string Não Termo de busca para filtrar por nome, sobrenome ou email do usuário.

Sucesso - 200

{
  "status": "success",
  "assessments": [
    {
      "assessment_id": "123",
      "licence": "LIC001",
      "assessment_type": "diagnóstico",
      "user_id": "456",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "avatarUrl": "https://api.soargi.com/avatar.jpg",
      "practitioner_id": "789",
      "practitioner_first_name": "Dr. Jane",
      "practitioner_last_name": "Smith",
      "org_names": ["OneFactory", "TechCorp"],
      "status": "pending",
      "date_assignment": "2024-01-15T10:00:00Z",
      "date_conclusion": null
    }
  ]
}

Erro - 401 (Token inválido)

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

Erro - 403 (Sem permissão)

{
  "status": 403,
  "error": "You do not have permission to access these assessments."
}

Códigos de Resposta

  • 200 - Lista de avaliações retornada com sucesso
  • 401 - Token inválido ou expirado
  • 403 - Sem permissão para acessar avaliações

Controle de Acesso por Role

  • Individual: Ve apenas suas próprias avaliações
  • Practitioner/Master Practitioner/Institutional: Ve suas avaliações e as de usuários vinculados
  • Admin/Super Admin: Ve todas as avaliações do sistema

Observações

  • É necessário estar autenticado para acessar este endpoint.
  • Os dados são filtrados automaticamente baseado no role do usuário.
  • O campo org_names retorna um array com os nomes das organizações do usuário.
  • As avaliações são ordenadas por data de criação (mais recentes primeiro).