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).