Versões comparadas

Versão antiga 5

changes.mady.by.user Igor Andrade

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Igor Andrade

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2093

Busca

CEP

Busca os dados do CEP informado.

Parâmetros de entrada


Image Added

Figura 1 - Bloco Buscar CEP

Compatibilidade

  • Bloco cliente mobile: cronapi.util.getCEP()

Retorno

Retorna um objeto JSON contendo os dados do CEP.

Parâmetros

CEP

NomeTipoDocParâmetro 1Texto

CEP a ser procurado, com ou sem pontuação

Parâmetro 2ComandoSucesso a ser exibido quando a função encontra o CEP

Retorno

Retorna um objeto JSON.

Compatibilidade

Image Removed Cliente

.

  • Posição: 1
  • Inglês: Zip Code
  • Tipo: Texto / String
  • Exemplo: "41830494", "41830-494".

Sucesso

Executa uma ação caso o CEP seja encontrado. 

  • Posição: 2
  • Inglês: Success
  • Tipo: Comando com retorno ("item") / Command with return ("item")
  • Exemplo: uso do bloco Imprimir ou Obter propriedade 

Exemplo

A função abaixo (Figura 1) recebe o bloco Buscar CEP contendo o CEP a ser procurado e o retorna o objeto na variável "item". Após obter com sucesso, a função imprime o conteúdo retornado.

Image Removed

Utilizamos dois blocos Imprime, o primeiro nos mostrará o objeto JSON por completo e o segundo imprimirá somente uma propriedade específica desse objeto, para isso, utilizamos o bloco Obter Propriedade.


Image Added

Figura 2 Figura 1 - Bloco Buscar CEP


Na Figura 2 o retorno é exibido no console do navegador contendo as o objeto JSON inteiro com informações relativas ao CEP e também o nome da cidade a qual pertence o CEP.


Image RemovedImage Added

Figura 2.1 - Retorno no console do navegador

Nesta Página

Índice

Sobre JSON

JSON é um acrônimo para "JavaScript Object Notation". Um formato de padrão aberto que utiliza texto legível a humanos para transmitir objetos de dados consistindo de pares chave-valor. É o formato de dados mais comumente utilizado para comunicação assíncrona navegador/servidor.

Um JSON é construído com base em uma coleção de pares chave-valor (que definem as propriedades e seus valores), iniciado com “{” (chave aberta) e finalizado com “}” (chave fechada) . Cada chave é seguida de “:” (dois pontos) e os pares são separados por “,” (vírgula).

Expandir
titleExemplo

{
    "nome":"Pedro",
    "site":"cronapp.io"
}

É possível ainda criar arrays dentro de objetos JSON. Um array é iniciado por “[” (colchete aberto) e finalizado por “]” (colchete fechado). Cada valor do array é separado por “,” (vírgula).

Expandir
titleExemplo

{"Clientes":[{"id":1, "nome":"João"},{"id":2, "nome":"Beatriz"}]}

Informações
titleMais sobre
JSON