/cepdb

:brazil: API de CEP Brasileiros com acesso gratuito e construida de maneira colaborativa ;}

cepdb

API de cep(brasileiros, claro) com acesso gratuito e construida de maneira colaborativa(pull requests) hospedada com Github Pages.

Como funciona?

cepdb usa Github Pages como hosting (afinal, são arquivos estáticos) e usamos JSONP para "burlar" o same origin policy e estar disponível "across" diferentes domains.

Como contribuir?

O repositório é construído de maneira colaborativa. Se você identificar que está faltando algum CEP ou quiser complementar as informações de um CEP existente, basta submeter um pull request com a correção. Simples né?

Como usar?

Vanilla Javascript:

    function jsonp(data) {
        alert(JSON.stringify(data));
    }
    var script = document.createElement('script');
    script.src = 'http://cepdb.com.br/api/v1/05422010.jsonp.js?callback=jsonp'
    document.getElementsByTagName('head')[0].appendChild(script);

CepDb Javascript plugin:

    bower install cepdb-js
  • Adicione uma tag script para o arquivo cepdb-js/index.js
    <script src="/bower_components/cepdb-js/index.js"></script>
  • E finalmente:
    var cepDb = new CepDb();
    cepDb.search('05422010', {
        onSuccess: function(data) {
            alert(JSON.stringify(data));
        },
        onTimeout: function() {
            alert('timed out :(');
        }
    });

Exemplos

Projetos relacionados