BuscaCep
- Active · last change 9-7-2026
- ★ 1 on GitHub
README
🚀 Buscador de CEP em Delphi (REST API)
Este é um projeto simples, direto e limpo desenvolvido em Delphi para demonstrar o consumo de APIs RESTful públicas, manipulação de JSON e boas práticas de engenharia de software (como tratamento rigoroso de exceções e controle de memória).
🎯 Objetivo
O aplicativo permite que o usuário digite um CEP (Código de Endereçamento Postal) e retorna o endereço completo formatado, consumindo a API aberta e gratuita do ViaCEP.
🛠️ Tecnologias e Técnicas Utilizadas
- Delphi / VCL (Visual Component Library): Criação da interface de usuário nativa e responsiva para Windows.
- TNetHTTPClient: Componente moderno do Delphi para requisições HTTP (GET), que utiliza a camada de rede nativa do SO, removendo a dependência de DLLs externas (como OpenSSL).
- System.JSON: Biblioteca nativa para parsing e extração segura de dados no formato JSON.
- Tratamento de Exceções (
try..except,try..finally): Garantia de liberação de memória para os objetos JSON e prevenção de crashes ao lidar com conexões de rede instáveis.
📸 Como funciona na prática
- O usuário insere um CEP (somente números).
- O aplicativo faz uma requisição HTTP GET assíncrona/segura para
https://viacep.com.br/ws/<CEP>/json/. - Os dados JSON recebidos são mapeados e extraídos tipadamente.
- O resultado é exibido formatado e limpo na interface.
- Se o CEP for inválido ou a rede cair, uma mensagem amigável de erro é mostrada ao usuário.
🚀 Como executar o projeto
- Clone este repositório para o seu computador.
- Abra o arquivo
BuscaCEP.dpr(ou o.dprojgerado) no RAD Studio / Delphi. - Pressione
F9(ou clique em Run) para compilar e executar a aplicação.
Desenvolvido para compor portfólio de habilidades modernas em Delphi.

