Como verificar validade de CEP usando API dos Correios em script?

Validar CEPs manualmente é uma tarefa repetitiva e propensa a erros. Utilizar a API dos Correios em um script automatiza este processo, garantindo precisão e economia de tempo em suas operações de logística ou cadastro de clientes.

Pré-requisitos

• Python 3.8 ou superior instalado
• Conexão com internet
• Editor de texto ou IDE (como VS Code ou PyCharm)

Passo 1: Configurar o ambiente Python

Antes de utilizar a API, é necessário preparar o ambiente Python com as bibliotecas necessárias. A biblioteca requests facilita a comunicação HTTP com a API dos Correios.

pip install requests

Passo 2: Criar o script de validação de CEP

Agora, vamos criar o script que fará a consulta à API dos Correios. O código abaixo verifica se o CEP é válido e retorna os dados do endereço associado.

import requests

def validar_cep(cep):
    url = f"https://viacep.com.br/ws/{cep}/json/"
    try:
        response = requests.get(url)
        data = response.json()
        if response.status_code == 200 and not data.get("erro"):
            return {
                "valido": True,
                "cep": data["cep"],
                "logradouro": data["logradouro"],
                "bairro": data["bairro"],
                "localidade": data["localidade"],
                "uf": data["uf"]
            }
        else:
            return {"valido": False}
    except Exception as e:
        return {"valido": False, "erro": str(e)}

# Exemplo de uso
cep = "01001000"
resultado = validar_cep(cep)
print(resultado)

Passo 3: Executar o script

Para executar o script, salve o código em um arquivo .py e execute-o no terminal. O resultado mostrará se o CEP é válido e, em caso positivo, retornará os dados completos do endereço.

python script_validar_cep.py

Exemplo Prático

Abaixo, veja uma tabela com exemplos de CEPs de entrada e os dados de saída esperados pelo script:

CEP de Entrada	Válido?	Logradouro	Bairro	Cidade	UF
01001000	Sim	Praça da Sé	Se	São Paulo	SP
00000000	Não	-	-	-	-
22010000	Sim	Praça Mal. Âncora	Centro	Rio de Janeiro	RJ

Conclusão

Com este script, você automatiza a validação de CEPs em segundos, eliminando erros manuais e garantindo a integridade dos dados em seus sistemas. A integração com a API dos Correios é simples e eficaz, tornando-se uma ferramenta essencial para desenvolvedores e analistas de dados.