Cepify: Uma API Gratuita de Consulta de CEP Compatível com o ViaCEP

Introdução

Há um tempo, eu estava procurando por um projeto para aplicar meu conhecimento em Spring Boot 4 e Java 25 de verdade. Ao mesmo tempo, eu estava lidando com um problema pessoal: sempre que precisava de uma consulta de CEP, dependia de serviços de terceiros que às vezes caíam ou limitavam bastante. Então, decidi criar Cepify, um webservice gratuito de consulta de CEP do Brasil.

Pitch: Criei o Cepify, uma API gratuita de consulta de CEP (compatível com o ViaCEP)

Funcionalidades

Cepify retorna dados em JSON, XML e JSONP. Ele também oferece busca por endereço (UF / cidade / logradouro). É compatível com o ViaCEP, com rotas no mesmo formato, incluindo o {"erro": "true"} para CEP inexistente. Isso permite que você apenas troque a URL base em seu código que já usa o ViaCEP.

API REST

Cepify oferece uma API REST 'correta' (/v1/ceps/{cep}), com ETag/Cache-Control e erros padronizados. É sem cadastro e sem API key, com rate limit por IP.

Decisões Técnicas

A base tem ~1,5 milhões de CEPs, carregada por um ETL que processa o e-DNE dos Correios. Atualizar isso sem derrubar a base em produção foi um trabalho honesto. O cache com Caffeine na frente das consultas deixou as respostas bem rápidas. A observabilidade é por log, não por tabela, o que é saudável para um serviço read-heavy e pensando em LGPD. A stack é composta por Spring Boot 4, Java 25, PostgreSQL, Caffeine, Flyway e Cloudflare.

Conclusão

Cepify é um projeto pessoal e gratuito. Não há SLA ou promessa de uptime empresarial, mas está no ar e funcionando. Fiz isso porque acho útil e porque foi um ótimo exercício com a stack nova. Se você quiser testar e me dar feedback, agradeço demais. Estou pensando nos próximos passos e queria ouvir quem usa isso no dia a dia. Como pretendo manter o projeto? Falo em custo de servidor e etc. Sobre as atualizações, de quanto em quanto tempo você faz a atualização?

Introdução

Funcionalidades

API REST

Decisões Técnicas

Conclusão

Tags