GET LIST

Em teste

GET

/user

###Endpoint para listagem de usuarios
Critérios da busca: name e permissions

Pre-definicoes: adicionar usuario no POST Register -> Sucesso

Descrição:

name: busca os usuarios de acordo com esse campo. Não faz distinção de letras maiúsculas ou minúsculas. (Campo opcional).

permissions: filtra os usuarios de acordo com suas permissoes dentro do sistema: ADMIN, SUPPORT, USER. (Campo opicional).

Alguns comportamentos esperados:

Requisição com campo name vazio: retorna todos os usuarios do banco

Requisição com campo permissions vazio: retorna os usuarios sem fazer distinção de permission

O campo deve estar vazio. Caso não seja chamado na requisição, resultará em erro.

Sobre o campo de retorno:

Usuario: lista de usuarios e seus demais campos

Sobre os Casos de Uso:
-> Sucesso: retorna 200
-> Registro Não Encontrado: retorna 404 (not found)
-> Dados Vazios: retorna 200 -> lista todos os usuários salvos
-> Parâmetros Faltantes: retorna 400 -> Bad request

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Consulta

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200List Users

application/json

Body

🟠400Formatos incorretos

🟠404Usuario Nao Enontrado

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://localhost:8080/user?name=Test&permission=ADMIN' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Response Example

200 - Sucesso

{
    "id": 1,
    "name": "Tester2",
    "email": "tester2@zscansoftware.com",
    "birthdate": "2002-01-02",
    "documentType": "CPF",
    "documentValue": "04044164232",
    "telephone": "(62) 994318404",
    "lastLogin": null,
    "permission": "admin",
    "active": true,
    "mustChangePassword": true
}

Modificado em 2026-02-25 13:46:18

Página anterior

Users

Próxima página