PyCEPCorreios

API para consulta de CEP diretamente do webservice dos Correios

Recursos | Documentação | Instalação | Como Usar | Como Contribuir | Créditos

Recursos

• Consulta de dados do endereço de um CEP
• Formatacao de CEP
• Validação de estrutura do CEP

Documentação

Para mais detalhes sobre a PyCEPCorreios, por gentileza, consulte a documentação oficial:

• Documentação online: docs
• Documentação PDF: download

Instalação

O PyCEP Correios pode ser facilmente instalado com o comando a seguir:

pip install pycep-correios

Atualmente, a PyCEPCorreios possui suporte para Python 3.5+.

Como usar

Consultar o endereço de um CEP é muito simples com o PyCEPCorreios. Veja os exemplos a seguir:

>>> import pycep_correios

>>> endereco = pycep_correios.consultar_cep('37503130')
>>> print(endereco)
{
    'bairro': 'Santo Antônio',
    'cep': '37503130',
    'cidade': 'Itajubá',
    'end': 'Rua Geraldino Campista',
    'uf': 'MG',
    'complemento2': '- até 214/215',
}

Como contribuir

Deseja participar do desenvolvimento da PyCepCorreios? Torne-se um contribuidor do PyCEPCorreios! visite a documentação para verificar a guideline de contribuição:

• Veja aqui.

Aviso de bugs, dúvidas e sugestões

Para dúvidas, sugestões e relatórios de bugs, por gentileza, crie uma issue:

• Issue Tracker: https://github.com/mstuttgart/pycep-correios/issues

Contribuidores

Agradecimentos aos seguintes contribuidores pelo esforço de fazer a PyCEPCorreios melhor:

• Lista de contribuidores: https://github.com/mstuttgart/pycep-correios/graphs/contributors

Créditos

Copyright (C) 2016-2019 por Michell Stuttgart