Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

Bloco de código
languagejs
firstline1
titlefiltrando pelo ID do objeto
linenumberstrue
{
	"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

  • Alterar a imagem
  • ver se vale a pena resumo (1 paragrafo pequeno sobre a query string)
  • mostrar como é formado a query string "&" "?" (o que vc colocou lá em baixo)
  • resultado


    Image Modified

    Figura 1 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:
      Selecione o método da requisição como
      • GET;
      Selecione o tipo
      • Tipo de conteúdo
      como
      • : JSON;
      • Informe o Endereço URL
       da
      • 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: id, nome, sabor, preco, quantidade, created_at e updated_et userId, id, title completed;
    4. 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

    Nessa página:

    Índice


    Outras informações:

    Web Services