http://viacep.com.br/ws/[cep-a-pesquisar]/json[formato]
http://viacep.com.br/ws/[cep[estado]/[cidade]/[string-ade-pesquisar]/xmlbusca]
Os formatos aceitos são o json
, xml
, jsonp
, querty
e piped
.
Busca por CEP
Eis aqui um exemplo, para o CEP 76.821-348, em JSON:
http://viacep.com.br/ws/76821348/json
http://viacep.com.br/ws/76821348/xml
O mesmo exemplo para XML:
http://viacep.com.br/ws/76821348/xml
Outros formatos suportados sãoPara o formato JSONP, Pipedbasta adicionar ?callback=nome_da_funcao
na URL terminada em JSON. Por exemplo:
http://viacep.com.br/ws/01001000/json?callback=foo
Dá como saída:
foo({
"cep": "01001-000",
"logradouro": "Praça da Sé",
"complemento": "lado ímpar",
"bairro": "Sé",
"localidade": "São Paulo",
"uf": "SP",
"unidade": "",
"ibge": "3550308",
"gia": "1004"
});
O formato piped (campos separados por |
e Quertychave separada de valor por :
), é assim:
http://viacep.com.br/ws/01001000/piped
cep:01001-000|logradouro:Praça da Sé|complemento:lado ímpar|bairro:Sé|localidade:São Paulo|uf:SP|unidade:|ibge:3550308|gia:1004
O formato querty é o formato usado em query-strings do tipo GET ou como corpo de requisição de formulários POST. Eis um exemplo:
http://viacep.com.br/ws/01001000/querty
cep=01001-000&logradouro=Pra%C3%A7a+da+S%C3%A9&complemento=lado+%C3%ADmpar&bairro=S%C3%A9&localidade=S%C3%A3o+Paulo&uf=SP&unidade=&ibge=3550308&gia=1004
Busca por endereço
Para a busca por endereços, o formato é quase o mesmo que a busca por CEPs (a diferença é que é trazida uma lista de logradouros ao invés de um único logradouro).
Eis aqui um exemplo:
http://viacep.com.br/ws/SP/S%C3%A3o%20Paulo/Vila%20Mariana/json
Eis a saída:
[
{
"cep": "04114-050",
"logradouro": "Praça Lions Clube-Vila Mariana",
"complemento": "",
"bairro": "Jardim da Glória",
"localidade": "São Paulo",
"uf": "SP",
"unidade": "",
"ibge": "3550308",
"gia": "1004"
},
{
"cep": "04112-015",
"logradouro": "Praça Comunitária da Vila Mariana",
"complemento": "",
"bairro": "Vila Mariana",
"localidade": "São Paulo",
"uf": "SP",
"unidade": "",
"ibge": "3550308",
"gia": "1004"
}
]