Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Catalog · How the catalog works
Anything · Lazarus or Delphi
Random projectRandom project

BuscaCep

View on GitHub

Member rating

No ratings yet.

Sign in to rate this project.

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

  1. O usuário insere um CEP (somente números).
  2. O aplicativo faz uma requisição HTTP GET assíncrona/segura para https://viacep.com.br/ws/<CEP>/json/.
  3. Os dados JSON recebidos são mapeados e extraídos tipadamente.
  4. O resultado é exibido formatado e limpo na interface.
  5. Se o CEP for inválido ou a rede cair, uma mensagem amigável de erro é mostrada ao usuário.

🚀 Como executar o projeto

  1. Clone este repositório para o seu computador.
  2. Abra o arquivo BuscaCEP.dpr (ou o .dproj gerado) no RAD Studio / Delphi.
  3. Pressione F9 (ou clique em Run) para compilar e executar a aplicação.

Desenvolvido para compor portfólio de habilidades modernas em Delphi.