cep-api icon indicating copy to clipboard operation
cep-api copied to clipboard

💩 API para desenvolvedores utilizarem em aplicações que precisem encontrar um endereço a partir do CEP informado.

[OBSOLETO] Address RESTful API

Este projeto está arquivado e não receberá mais atualizações.

API para desenvolvedores utilizarem em aplicações que precisem encontrar um endereço a partir do CEP informado. (Os dados vem direto da base de dados dos correios)

Acesse: http://correiosapi.apphb.com/cep/76873274

e veja um exemplo de resultado!

Retornos:

Em caso de sucesso:

{
  "bairro": "Setor Institucional",
  "cep": "76872862",
  "cidade": "Ariquemes",
  "estado": "RO",
  "logradouro": "Rio Madeira ",
  "tipoDeLogradouro": "Rua"
}

Em caso de erro de CEP não encontrado a API retornará o HTTP Status 404

Exemplos de uso

Jquery:

$.ajax({
  url: 'http://correiosapi.apphb.com/cep/76873274',
  dataType: 'jsonp',
  crossDomain: true,
  contentType: "application/json",
  statusCode: {
    200: function(data) { console.log(data); } // Ok
    ,400: function(msg) { console.log(msg);  } // Bad Request
    ,404: function(msg) { console.log("CEP não encontrado!!"); } // Not Found
  }
});​

Contribua

Faça um fork do projeto e ajude a melhorar o código, isso foi só uma brincadeira na madrugada!