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.
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.
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}