Validador de CEP

📮 Validação de CEP Online

Nosso validador de CEP verifica se um código postal brasileiro é válido e, opcionalmente, consulta o endereço completo na base dos Correios através da API ViaCEP.

O CEP (Código de Endereçamento Postal) é um sistema criado pelos Correios para facilitar a entrega de correspondências. Cada CEP identifica uma localização específica no Brasil.

✅ O que é Validado?

• Formato: 8 dígitos no formato 00000-000
• Números Válidos: Não pode ser 00000-000 ou ter todos os dígitos iguais
• Existência: Consulta opcional na base dos Correios via ViaCEP
• Endereço Completo: Retorna logradouro, bairro, cidade, UF, DDD e outros

🌐 API ViaCEP

A ViaCEP é um webservice gratuito de consulta de CEP. Ele retorna informações completas de endereço em formato JSON, facilitando a integração em aplicações web.

Exemplo de Resposta:

{
  "cep": "01310-100",
  "logradouro": "Avenida Paulista",
  "complemento": "lado ímpar",
  "bairro": "Bela Vista",
  "localidade": "São Paulo",
  "uf": "SP",
  "ibge": "3550308",
  "gia": "1004",
  "ddd": "11",
  "siafi": "7107"
}

💻 Exemplo de Código - JavaScript

async function consultarCEP(cep) {
    const cepLimpo = cep.replace(/\\D/g, '');

    if (cepLimpo.length !== 8) {
        throw new Error('CEP deve ter 8 dígitos');
    }

    const response = await fetch(
        `https://viacep.com.br/ws/${cepLimpo}/json/`
    );

    const data = await response.json();

    if (data.erro) {
        throw new Error('CEP não encontrado');
    }

    return data;
}

// Exemplo de uso
consultarCEP('01310-100')
    .then(dados => console.log(dados))
    .catch(erro => console.error(erro));

📊 Estrutura do CEP

O CEP brasileiro tem 8 dígitos divididos em regiões:

• 1º Dígito: Identifica a região (0=SP capital, 1=SP interior, 2=RJ/ES, 3=MG, 4=BA/SE, etc.)
• 2º e 3º Dígitos: Sub-região
• 4º e 5º Dígitos: Setor
• 6º a 8º Dígitos: Identificador de distribuição

❓ FAQ

1. O validador funciona offline?

A validação de formato funciona offline. A consulta de endereço requer conexão com a internet para acessar a API ViaCEP.

2. A API ViaCEP é gratuita?

Sim! A ViaCEP é um serviço público e gratuito mantido pela comunidade. Não requer cadastro ou chave de API.

3. CEPs com 00000-000 são válidos?

Não. 00000-000 e CEPs com todos os dígitos iguais são inválidos e rejeitados pelo validador.

4. Posso usar em aplicações comerciais?

Sim! Tanto nosso validador quanto a API ViaCEP podem ser usados livremente em projetos pessoais e comerciais.