Backend · Brasil

Consulta de CEP

Preenche o endereço pelo CEP na BrasilAPI v2 com fallback ViaCEP, retorno normalizado e cache. Checkout e cadastro mais rápidos, com menos erro de entrega.

CEP · ViaCEP · Endereço · 8 testes automatizados · Licença MIT · Criado por FlowCore Soluções LTDA

Como instalar

  1. Funciona onde você já roda Node 18+, Cloudflare Workers, Deno, Bun, Vercel e Netlify Functions. Zero dependência: só fetch e Web Crypto, que já vêm no runtime.
  2. Crie src/lib/consulta-cep.ts Cole o código da aba Código.
  3. Use
    const cep = criarConsultaCep();
const endereco = await cep.consultar("01001-000");
// { logradouro: "Praça da Sé", bairro: "Sé", cidade: "São Paulo", uf: "SP", ... }
  4. Rode o teste junto O arquivo de teste (aba Teste) cobre 8 cenários. Copie para src/lib/ ao lado e rode:
    npm install -D vitest
npx vitest run src/lib

Código no GitHub · Biblioteca de códigos

Mais em Brasil