Estamos com mais uma atualização para a API CEP & IBGE Code: a adição de mais um campo de retorno, o campo “iscapital”. Esse trará como retorno o valor 0 (zero) para cidades que não são capitais e 1 (um) para cidades que são capitais.

Assim, se você efetuar uma busca pelo CEP que pertence a cidade do Rio de Janeiro, esse campo virá com o valor igual a 1. Já no caso de usar um CEP de uma cidade que não é capital como, por exemplo Niterói/RJ, o campo iscapital virá com o valor igual à 0.

Esse novo retorno é válido para os tipos XML e JSON e estará disponível a partir do dia 06/01/2015 às 10:00 (Horário de Brasília).

Vejamos os exemplos de retornos para o CEP 20270-004 que faz parte do Rio de Janeiro capital, conforme a Figura 1 e Listagem 1.

XML

Figura 1. XML

Listagem 1. JSON


  {"resultado_txt":"sucesso","usuario":{"login":"teste3","nome":null,"email":"teste3@devmedia.com.br","telefone":""},"uf":"RJ","cidade":"Rio de Janeiro","bairro":"Maracan\u00e3","estado":"Rio de Janeiro","logradouro":"Rua Mariz e Barros - de 593 ao fim - lado \u00edmpar","unidade":"","cpc":"","logradouro_curto":"Rua Mariz e Barros","codigomunicipio":3304557,"iscapital":1}

Agora vejamos os exemplos de retornos para o CEP 24020-120, que não faz parte da capital do Rio de Janeiro, conforme mostram a Figura 2 e Listagem 2.

'XML

Figura 2. XML

Listagem 2. JSON


  {"resultado_txt":"sucesso","usuario":{"login":"teste3","nome":null,"email":"teste3@devmedia.com.br","telefone":""},"uf":"RJ","cidade":"Niter\u00f3i","bairro":"Centro","estado":"Rio de Janeiro","logradouro":"Travessa S\u00e3o Jorge","unidade":"","cpc":"","logradouro_curto":"Travessa S\u00e3o Jorge","codigomunicipio":3303302,"iscapital":0}