Nesta API encontrará as funções essenciais relacionadas ao gerenciamento de contas bancárias
Navegue pelo sumário abaixo
Inicio • Pré Requisitos (Instalação) • Como Executar o projeto • Testar no Swagger • Testar no Postman • Tecnologias • Autor
- O teste da API pode ser feito pelo Swagger ou Postman • Sugestão do autor: Swagger
- Para abrir uma conta é necessário apenas o nome completo e CPF da pessoa, mas só é permitido uma conta por pessoa
- Com essa conta é possível realizar transferências para outras contas e depositar
- Não aceitamos valores negativos nas contas
- Por questão de segurança cada transação de depósito não pode ser maior do que R$2.000
- Este Projeto foi Documentado com Swagger para facilitar os testes
Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas:
- IntelliJ IDEA Community Edition para executar o projeto de maneira local;
- JDK 17.0.1;
- MySQL 8.0.27;
- Opcional MySQL Workbench, caso deseje visualizar o banco de dados;
- Opcional Postman opcional caso queira visualizar com o postman.
Você também precisará fazer a seguinte configuração (siga o caminho abaixo)
- Clique com o botão direito em "Meu Computador";
- Clique em "Propriedades";
- Clique em "Configurações Avançadas do Sistema";
- Clique em "Variáveis de Ambiente";
- Copie o caminho para onde você fez o download do JDK 17.0.1;
- Em "Variáveis de Ambiente>Variáveis do Sistema" clique em "novo" e insira o nome da variável como sendo "JAVA_HOME" e insira o caminho do JDK 17.0.1 que você copiou e clique em "OK";
- Ainda em "Variáveis de Ambiente>Variáveis do Sistema" clique em "novo" e insira o nome da variável como sendo "CLASSPATH" e no valor coloque um ponto "." e depois clique em "OK";
- Em "Variáveis do Sistema" localize o "Path" e dê um duplo clique sobre ele, e adicione "%JAVA_HOME%\bin" e mova-o para cima e depois clique em "OK" e novamente em "OK";
- Para validar a instalação do JDK abra o cmd e digite "java -version" e aparecerá a versão do java instalado.
# Clone este repositório
$ git clone https://github.com/ergonlima/API-Banco-Digital/tree/main/desafio-rest-api- Abra o IntelliJ IDEA Community Edition que você instalou e depois abra o projeto;
- Localize na parte direita superior lateral uma aba chamada "Maven" e a abra;
- Clique em "Reload All Maven Projects" para sincronizar e baixar as dependências do Maven;
- Após isso, basta clicar na seta verde ou apertar "shift+F10" e a API já estará executando.
-Todas as Mensagens de Exceção são exibidas no log da IDE
Cole no seu navegador o link abaixo ou Clique Aqui
# http://localhost:8080/swagger-ui/#/conta-bancaria-controllerA tela abaixo será apresentada
-Antes de inserir o Parâmetro solicitado, sempre aperte em "Try it out" EM TODOS OS MÉTODOS
-Depois insira o id e clique em "Execute", O resultado será exibido abaixo em forma de JSON
-Clique em "Execute", O resultado será exibido abaixo em forma de JSON
-Insira o CPF e o nome do Cliente do Banco, não é possível inserir dois usuários com o mesmo CPF, cumprindo assim a regra de não cadastrar a mesma pessoa duas vezes
-Depois Clique em "Execute" e o usuário estará cadastrado se retornar status 200 OK
-Insira o Id e Clique em "Execute", após isso a conta será excluída"
-Insira o Id da conta que deseja depositar o dinheiro e depois informe o valor e Clique em "Execute", após isso o dinheiro será depositado, é possível ver o resultado usando a função de busca por Id
-Só é possível realizar depósitos entre R$ 0,00 e R$ 2000,00
-Insira o Id de quem receberá o dinheiro (idDestino)
-Insira o Id de quem Enviará o dinheiro (idOrigem)
-Insira o Valor da Transferência
Só é possível realizar transferências entre R$ 0,00 e R$ 2000,00 e o cliente não pode enviar valores a mais do que possui
-Todas as Mensagens de Exceção são exibidas no log da IDE
# Clone este repositório da collection do Postman
$ https://github.com/ergonlima/API-Banco-Digital/tree/main/collection-postmanApós isso, importe o arquivo .json para o Postman
A collection ficará assim
-Insira o CPF e o nome do Cliente do Banco, não é possível inserir dois usuários com o mesmo CPF, cumprindo assim a regra de não cadastrar a mesma pessoa duas vezes
-Depois Clique em "Send" e o usuário estará cadastrado se retornar status 200 OK
-Insira o id na url e clique em "Send", O resultado será exibido abaixo em forma de JSON
-Insira o Id da conta que deseja depositar o dinheiro e depois informe o valor e Clique em "Send", após isso o dinheiro será depositado, é possível ver o resultado usando a função de busca por Id
-Só é possível realizar depósitos entre R$ 0,00 e R$ 2000,00
-Insira o Id de quem receberá o dinheiro (idDestino)
-Insira o Id de quem Enviará o dinheiro (idOrigem)
-Insira o Valor da Transferência
Só é possível realizar transferências entre R$ 0,00 e R$ 2000,00 e o cliente não pode enviar valores a mais do que possui
-Insira o Id e Clique em "Send", após isso a conta será excluída"
-Clique em "Send", O resultado será exibido abaixo em forma de JSON
As seguintes ferramentas foram usadas na construção do projeto:
Made by Ergon Zamarian Lima 👋😁