Pré requisitos

1. Projeto do tipo mobile ou web criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link ( Criar projeto );

Passos

Antes de consumir um serviço REST no Cronapp, é importante garantir que você já tenha um serviço que disponibilize. Para saber como criar um dentro do Cronapp acesse a página Disponibilizando Web Service Rest.

Neste exemplo foi utilizado uma API externa gratuita de testes (https://jsonplaceholder.typicode.com/todos/), ela retorna um array de objetos.

É possível filtrar o objeto informando o seu ID no final do endereço: https://jsonplaceholder.typicode.com/todos/2

{
	"userId": 1,
	"id": 2,
	"title": "quis ut nam facilis et officia qui",
	"completed": false
}

Consumindo Serviço REST

Para consumir web services REST, o Cronapp disponibiliza duas funções em sua API. Elas permitem obter tanto o conteúdo disponibilizado pelo serviço quanto o cabeçalho da requisição, caso necessite.

Neste exemplo usaremos o bloco servidor Obter Conteúdo da requisição.

Ver mais detalhes : https://blog.octo.com/pt-br/projetando-uma-api-rest/ (tópico granularidade / / / / ) e tópico querystring

Via URI

• Mostrar o filtro direto pela URI (api.coim,br/produtos/{id} )
• ver se vale a pena resumo (1 paragrafo pequeno sobre a granularidade)
• imagem e resultado

Via Query String

Figura x - Bloco Obter conteúdo da URL

1. Adicione o bloco imprime;
2. Adicione o bloco Obter conteúdo da URL;
   • Método de requisição: GET;
   • Tipo de conteúdo: JSON;
   • Informe o Endereço URL da sua API;
3. Adicione o bloco criar mapa e configure um ou mais Parâmetros de acordo com os campos da sua API, nesse caso poderíamos escolher entre: userId, id, title e completed;
4. Escreva o filtro de acordo com o campo escolhido, nesse caso 1, que é um id.

Estrutura do Query String

https://jsonplaceholder.typicode.com/todos?id=1&completed=false

URL domínio / todos ? id = 1 & completed = false

• todos: Função que irá buscar nosso registro;
• ?: Separa a função dos parâmetros chave (key);
• id: Chave (key), parâmetro a ser usado para obter o registro;
• 1: Valor (value) especificado na chave (key);
• &: ampersand que permite adicionar outro parâmetro na URL.

Testando API

O bloco imprime foi adicionado a função para validar corretamente o funcionamento da sua API no console do depurador do Cronapp.

Para realizar o teste, adicione um botão em uma view e vincule o Blockly criado ao botão. Após isso, acesse a aplicação, clique sobre o botão e observe a resposta que irá aparecer no console do depurador.

Figura x - Console do depurador exibindo JSON retornado via Query String