Disponibilizado BASE de dados de CEP

Utilize a base localmente, utilize o WebService apenas se não encontrar o CEP nesta base de dados.

Download da base de dados de CEP

Como funciona o WebService de CEP?

Através de uma solicitação HTTP as variáveis são enviadas GET é retornado um documento no formato solicitado com o endereço do CEP.

URL WebService: http://cep.republicavirtual.com.br/web_cep.php

Variáveis de entrada:

cep (númerico com 8 dígitos, ex: 90200971)

formato (string, pode ser: xml, query_string, ou jsonp ou javascript)

callback (opcional, string, função em js que será executada - jsonp)

busca on-line

um pequeno exemplo de utilização utilizando formato JAVASCRIPT, utizando AJAX

buscar cep CEP:

Requisitando o retorno em JSONP

CEP: 91010000
Formato de retorno: javascript
URL: http://cep.republicavirtual.com.br/web_cep.php?cep=91010000&formato=jsonp&callback=minhaFuncaoJS

resultado

minhaFuncaoJS({"resultado":"1","resultado_txt":"sucesso - cep completo","uf":"RS","cidade":"Porto Alegre","bairro":"Passo D'Areia","tipo_logradouro":"Avenida","logradouro":"Assis Brasil"})

Requisitando o retorno em JSON (para utilizar com AJAX)

CEP: 91010000
Formato de retorno: javascript
URL: http://cep.republicavirtual.com.br/web_cep.php?cep=91010000&formato=json

resultado

{"resultado":"1","resultado_txt":"sucesso - cep completo","uf":"RS","cidade":"Porto Alegre","bairro":"Passo D'Areia","tipo_logradouro":"Avenida","logradouro":"Assis Brasil"}

Requisitando o retorno em JAVA-SCRIPT (para utilizar com AJAX)

CEP: 91010000
Formato de retorno: javascript
URL: http://cep.republicavirtual.com.br/web_cep.php?cep=91010000&formato=javascript

resultado

var resultadoCEP = {
	'uf' 			: 'RS',
	'cidade' 		: 'Porto%20Alegre',
	'bairro' 		: 'Passo%20D%27Areia',
	'tipo_logradouro' 	: 'Avenida',
	'logradouro' 		: 'Assis%20Brasil',
	'resultado' 		: '1',
	'resultado_txt' 	: 'sucesso%20-%20cep%20completo'
}

Requisitando o retorno em XML

CEP: 91010000
Formato de retorno: xml
URL: http://cep.republicavirtual.com.br/web_cep.php?cep=91010000&formato=xml

resultado

<?xml version="1.0" encoding="iso-8859-1"?>
<webservicecep>
<uf>RS</uf>
<cidade>Porto Alegre</cidade>
<bairro>Passo D'Areia</bairro>
<tipo_logradouro>Avenida</tipo_logradouro>
<logradouro>Assis Brasil</logradouro>
<resultado>1</resultado>
<resultado_txt>sucesso - cep completo</resultado_txt>
</webservicecep>

Requisitando o retorno em QUERY STRING

CEP: 91010000
Formato de retorno: query_string
URL: http://cep.republicavirtual.com.br/web_cep.php?cep=91010000&formato=query_string

resultado

&uf=RS&cidade=Porto+Alegre&bairro=Passo+D%27Areia&tipo_logradouro=Avenida&logradouro=Assis+Brasil&resultado=1&resultado_txt=sucesso+-+cep+completo