emersonsoares/cep-api

💩 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!

cep-api's Issues

Ceps únicos não funcionam

Ceps unicos para cidades não funcionam.
ex:
93900000 = Ivoti-RS
93600000 = Estância Velha-RS

Frequência de atualização da base

Opa, tudo bem? Muito legal sua API.

A API faz consulta em uma base de dados sua, certo? Acredito que não deve ser direto na base dos Correios...
De quanto em quanto tempo você atualiza essa base com informações dos Correios? (Adição de CEPs, alterações etc)...

É importante saber isso se for usar em produção :)

Obrigado.

De onde vem os dados?

De onde vem os dados que você utiliza? Se importaria de compartilhá-los também?

CEP alterado

Existem alguns CEPs que foram alterados pelos correios, conforme a imagem:

Seria interessante informar o CEP alterado no retorno, pois auxilia a consulta de preços e prazos com os correios.
Informando estes CEPs como o de exemplo(13170-000) o serviço deles não retorna valor e prazo.

CORS

Como configurar a API para o uso de CORS?

Endereço não encontrado

Olá Emerson!

Parabéns pela API, ela é de grande ajuda!
Mas não sei se o correio mudou alguma coisa, pois ela está retornando Endereço não encontrado para qualquer CEP. Inclusive o que está como demo no site.

Reparei que desde domingo pela manhã já não estava retornando resultado, agora entrei direto no site, fiz o teste por lá e realmente só retorna essa mensagem.

Usei para teste os CEPs 04578-000 e 09920-000

Bug, quando o CEP começa com o digito zero

Quando consultado um CEP iniciando com o digito zero a API retira o primeiro digito, e preenche o ultimo com um zero, causando um bug no retorno do endereço correto.

Exemplo, cep 03303-000 que é de São Paulo, mas a API retorna um endereço de Minas Gerais.

Problemas com charset.

Muito gostei da iniciativa, e está funcionando como uma mão na roda, porém tive um problema ao trabalhar com acentuações, exemplo do CEP 59064-902 (http://correiosapi.apphb.com/cep/59064902)

Meu "forte" não é Asp.NET, mas vamos lá me fazer entender:

A aplicação inteira está trabalhando em UTF-8, porém o site dos Correios (http://m.correios.com.br/movel/buscaCepConfirma.do) está trabalhando com ISO-8859-1.

Fuçando e acredito que basta apenas utilizar uma conversão da resposta em ISO p/ UTF-8 no "CorreiosRestful.API/Helpers/EnderecoParse.cs", a provável correção pode ser vista aqui: http://stackoverflow.com/questions/1922199/c-sharp-convert-string-from-utf-8-to-iso-8859-1-latin1-h

Quanto for pra um ambiente Windows faço um fork e testo aqui :)

Parou de Funcionar?

Já tem 3 dias que não está funcionando, alguma mudança?