construir uma API REST de consulta de endereço e cálculo de frete para um determinado CEP
- Fonte de dados: https://viacep.com.br/
O valor do frete é fixo de acordo com as regiões do Brasil: Sudeste (R$ 7,85), Centro-Oeste (R$ 12,50), Nordeste (R$ 15,98), Sul (R$ 17,30) e Norte (R$ 20,83). O CEP é obrigatório e pode ser passado com ou sem máscara na entrada e se o CEP não for encontrado uma mensagem informativa deve ser retornada para o cliente.
Java 11
Spring boot
API REST Template
Documentação Swagger
Testes unitários JUnit5
Testes automatizados utilizando cucumber
Clonar o repositório
Copie o link do repositório abaixo e clone para o diretório de sua preferência.
https://github.com/vanessatauchert/Api-Cep.git
Após a execução do programa é possível visualizar os endpoints disponiveis no Swwager atráves do link: http://localhost:8080/swagger-ui/index.html#/
Método | Url | Descrição |
---|---|---|
POST | localhost:8080/v1/consulta-endereco | Consulta o Endereço e valor do frete pelo Cep digitado |
A collection dos endpoints no Insomnia
pode ser encontrada para download na pasta: src\main\resources\collection\Insomnia_2023-04-14.json
Para rodar os testes você pode digitar o comando mvn test
Também é possível testar cada teste diretamente nas classes de testes no caminho src\main\test
Para verificar a cobertura dos testes, basta clicar com o botão direito sobre o pacote principal da pasta teste,
selecionar Modify Run Configuration
em Code Coverage
selecione o JaCoCo
clique em Apply
e OK
Clique novamente com o botão direito sobre o pacote principal da pasta teste e selecione a terceira opção Run Tests with Coverage
após a
execução será apresentada a cobertura dos testes.
Java 11
-SpringBoot 2.7.10
-Intellij
-Maven 3
-Swagger
-RestTemplate
-JUnit5
-Jacoco
-Insomnia
-Git
-GitHub
Vanessa Oliveira |
---|