Pitch: Criei o Cepify, uma API gratuita de consulta de CEP (compatível com o ViaCEP)
Há um tempo eu queria um projeto pra colocar a mão no Spring Boot 4 + Java 25 de verdade, e acabei
resolvendo um incômodo pessoal: sempre que preciso de consulta de CEP, dependo de serviços de terceiros que
às vezes caem ou limitam bastante. Então construí o Cepify, um webservice gratuito de consulta de CEP do
Brasil.
O que ele faz
- Consulta de CEP retornando JSON, XML e JSONP
- Busca por endereço (UF / cidade / logradouro)
- Compatibilidade com o ViaCEP: tem rotas no mesmo formato (inclusive o
{"erro": "true"}pra CEP
inexistente), então dá pra só trocar a URL base em código que já usa ViaCEP - Uma API REST "correta" também (
/v1/ceps/{cep}), comETag/Cache-Controle erros padronizados - Sem cadastro e sem API key, com rate limit por IP
Decisões técnicas que achei interessantes
- A base tem ~1,5 milhão de CEPs, carregada por um ETL que processa o e-DNE dos Correios. Atualizar
isso sem derrubar a base em produção deu um trabalho honesto. - Cache com Caffeine na frente das consultas (o serviço é muito mais leitura do que escrita) — deixou as
respostas bem rápidas. - Observabilidade por log, não por tabela: cada request vira uma linha de log de acesso em JSON +
métricas no Prometheus. Pra um serviço read-heavy, e pensando em LGPD, achei mais saudável do que gravar
tudo em banco. - Documentação via Swagger/OpenAPI.
Stack resumida: Spring Boot 4, Java 25, PostgreSQL, Caffeine, Flyway, atrás da Cloudflare.
Sobre o projeto
É um projeto pessoal e gratuito — não tem SLA nem promessa de uptime empresarial, mas está no ar e
funcionando. Fiz porque acho útil e porque foi um ótimo exercício com a stack nova.
Se quiserem testar e me dar feedback, agradeço demais. Em especial: o que vocês esperariam de uma API de
CEP que o ViaCEP (ou outras) não entrega hoje? Estou pensando nos próximos passos e queria ouvir quem usa
isso no dia a dia.