API para desenvolvedores utilizarem em aplicações que precisem encontrar um endereço a partir do CEP informado.
C# CSS Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.nuget
AddressApi.Base.Tests
AddressApi.Base
AddressApi.Correios.Tests
AddressApi.Correios
AddressApi.RestApi
packages
.gitattributes
.gitignore
AddressApi.sln
README.md

README.md

Address RESTful API

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!