consulta-cep
📦 Consulta CEP API
API REST desenvolvida com Spring Boot para realizar consultas de endereço a partir de um CEP, utilizando o serviço gratuito ViaCEP. Inclui também uma página HTML simples para o usuário consultar o CEP pelo navegador.
✨ Funcionalidades
- 🔍 Consulta de endereço via CEP (Integração com ViaCEP)
- ⚡ API REST rápida e simples
- 🛠️ Exemplo de consumo de API externa com RestTemplate
- 🌐 Interface Web para consulta de CEP
🚀 Tecnologias
- Java 17
- Spring Boot 3.4.5
- Maven
- ViaCEP API
📂 Estrutura de Pastas
consulta-cep/
├── src/
│ ├── main/
│ │ ├── java/com/reginalddev/consultacep/
│ │ │ ├── controller/
│ │ │ ├── model/
│ │ │ └── service/
│ │ ├── resources/
│ │ │ ├── static/
│ │ │ │ └── index.html
│ │ │ └── application.properties
│ └── test/
├── pom.xml
└── README.md
⚙️ Como rodar o projeto
1️⃣ Clone o repositório
git clone https://github.com/ReginaldDev/consulta-cep.git
cd consulta-cep
2️⃣ Compile o projeto
./mvnw clean install
3️⃣ Execute a aplicação
./mvnw spring-boot:run
A API estará disponível em:
http://localhost:8080
🛠️ Exemplo de uso
Endpoint
GET /api/cep/{cep}
Exemplo
GET http://localhost:8080/api/cep/01001000
Retorno (JSON)
{
"cep": "01001-000",
"logradouro": "Praça da Sé",
"complemento": "lado ímpar",
"bairro": "Sé",
"localidade": "São Paulo",
"uf": "SP",
"ibge": "3550308",
"gia": "1004",
"ddd": "11",
"siafi": "7107"
}
🌐 Interface Web
A aplicação possui uma página simples para consultar o CEP diretamente pelo navegador.
Acesse
http://localhost:8080/index.html
Como usar
1️⃣ Informe o CEP no campo 2️⃣ Clique em Consultar 3️⃣ O endereço será exibido abaixo
✍️ Autor
Reginaldo Junior
⚖️ Licença
Este projeto está licenciado sob a licença MIT.
Veja o arquivo LICENSE para mais detalhes.