A aplicação, desenvolvida em Java, expõe uma API de cadastro, alteração, remoção e consulta de pessoas com as seguintes informações:
- Nome - obrigatório
- Sexo
- E-mail - não obrigatório, com validação caso preenchido
- Data de Nascimento - obrigatória, com validação
- Naturalidade
- Nacionalidade
- CPF - obrigatório, com validação (formato e não pode haver dois cadastros com mesmo cpf)
O acesso à aplicação está protegido por OAuth com um header de autorização via Basic.
A API está toda documentada e pode ser acessada através do link http://localhost:8080/swagger-ui.html após rodar a aplicação.
Para acessar os endpoints protegidos por OAuth, é necessário um bearer access token que pode ser gerado através do seguinte passo-a-passo no Postman :
- Preparar o seguinte Request HTTP do tipo POST na URL localhost:8080/oauth/token
- Na aba Body, criar e preencher os campos "username", "password" e "grant_type" de acordo com a configuração exigida :
username : root, password : root, grant_type : password
- Na aba Authorization, selecionar Basic Auth como header de autenticação e preencher os campos "Username" e "Password" com as credenciais "root" e "root" :
- Por fim, um response body com o bearer access token será gerado para acessar os endpoints protegidos :