Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "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.
Informações |
---|
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. |
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 resultado
Via Query String
Image Modified
Figura 1 x - Bloco Obter conteúdo da URL
- 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: id, nome, sabor, preco, quantidade, created_at e updated_et userId, id, title e completed;
- Escreva o filtro de acordo com o campo escolhido, nesse caso Bolo 1, que é um nome id.
Informações |
---|
Caso queira obter todos os dados presentes na API remova o bloco criar mapa. |
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.
Image Removed
Figura 2 - Adicionando Botão e vinculando Blockly
Image Removed
Figura 3 - Console do depurador exibindo JSON retornado pela API
Essa mesma API pode ser testada em outras plataformas a exemplo do Postman, seguindo o padrão do bloco Obter conteúdo da URL (Query String).Estrutura do Query String
https://my-api-strapi.herokuappjsonplaceholder.typicode.com/produtostodos?precoid=151&nomecompleted=Bolofalse
URL domínio / produtos todos ? preco id = 15 1 & nome completed = Bolofalse
- produtos
- todos: É a função
- Função que irá buscar nosso registro;
- ?: Separa a função dos parâmetros chave (key); preco
- id: É uma chave
- Chave (key), parâmetro a ser usado para obter o registro; 15
- 1: É o valor
- Valor (value) especificado na chave (key);
- &: ampersand
- 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.
Image Added
Figura x - Console do depurador exibindo JSON retornado via Query String