- Criado por Pedro Lima, última alteração em 13/07/2020
Você está vendo a versão antiga da página. Ver a versão atual.
Comparar com o atual Ver Histórico da Página
« Anterior Versão 24 Próxima »
Pré requisitos
- 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.
Os blocos de programação Clientes são assíncronos, dessa forma, será necessário além do bloco de requisição REST, usar também o bloco Promessa, que fica aguardando a resposta do serviço para dar continuidade a execução da função. Para saber mais acesse a documentação.
Via URI
Um URI é um identificador de recurso que identifica exclusivamente uma instância específica de um tipo de recurso, no caso do nosso exemplo foi utilizado a função todos que espera receber um id como parâmetro.
Figura 1 - Bloco Obter conteúdo da URL via URI
- Adicione o bloco imprime;
- 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 com o parâmetro do recurso a ser obtido;
Caso queira obter todos os dados presentes na API remova o parâmetro {id}.
Estrutura do URI
https://jsonplaceholder.typicode.com/todos/25
URL domínio / todos / 25
- todos: Função que irá buscar nosso registro;
- /: Separa a função dos parâmetros chave (key);
- 25: Valor (value) especificado na chave (key);
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 2 - Console do depurador exibindo JSON retornado via URI
Via Query String
A requisição via query string nos permite utilizar diversos parâmetros como filtro para obter um registro específico da API.
Figura 3 - Bloco Obter conteúdo da URL via Query String
- Adicione o bloco imprime;
- 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;
- 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;
- 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 4 - Console do depurador exibindo JSON retornado via Query String
- Sem rótulos