Validar o CEP antes de consultar
Um CEP tem 8 números. Conferir isso no seu sistema evita gastar consulta com número digitado pela metade.
Publicado em .
Fontes oficiais: o CEP nos Correios e os códigos de município do IBGE.
Diferente do CNPJ, o CEP não tem dígito verificador. A conferência possível antes de consultar é o formato: 8 números.
O código
export function limparCep(texto) {
return String(texto).replace(/\D/g, "");
}
export function cepValido(texto) {
const so = String(texto).trim();
return /^\d{5}-?\d{3}$/.test(so) || /^\d{2}\.\d{3}-\d{3}$/.test(so);
}
Conferido contra a API
| Entrada | cepValido | Resposta da API |
|---|---|---|
01001000 | true | 200, Praça da Sé |
01001-000 | true | 200, o mesmo endereço |
01.001-000 | true | consulte com limparCep |
1234 | false | 400 cep_invalido |
99999999 | true | 404 nao_encontrado |
A função recusa letras e números soltos, mas aceita o CEP escrito do jeito que as pessoas costumam escrever, com traço ou com ponto.
Perguntas e respostas
Quais formatos de CEP a API aceita?
8 números, com ou sem traço: 01001000 e 01001-000 dão a mesma resposta.
O que acontece se eu mandar um CEP com menos números?
A API responde 400 com o código cep_invalido, e a consulta conta no seu limite de 60 por minuto.
Um CEP com 8 números sempre existe?
Não. Se ele não está na base dos Correios, a resposta é 404 com o código nao_encontrado.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA