Bloco responsável por realizar uma requisição REST a partir do recurso (URL) informado.
Figura 1 - Bloco Obter conteúdo da URL
Retorna o conteúdo da requisição REST com base no que foi selecionado no parâmetro Tipo de resposta.
Descrição dos parâmetros do bloco.
A partir da versão do |
Permite selecionar o verbo HTTP do recurso.
GET
, porém sem conter o corpo da resposta.Acesse Métodos de requisição HTTP para maiores informações. |
Define o formato passado no corpo da requisição. Em geral, esse parâmetro é mais utilizado em requisições do tipo PUT e POST.
Veja mais detalhes sobre os formatos "x-www-form-urlencoded" e "multipart/form-data" em POST - HTTP. |
Endereço URI da requisição REST.
É comum utilizarmos o bloco Criar texto com para concatenar a URL base da API (ex: "https://minhaapi.com/user/
") com o identificador do recurso obtido via parâmetro da função de bloco (ex: "345678
").
https://minhaapi.com/user/345678/info
"Parâmetros a serem utilizados como filtros da requisição. É necessário passar um mapa (ou objeto JSON) com atributo para cada parâmetro.
{"id":"345678"}
"Objeto com atributos a serem tratados pelo serviço. É necessário passar um mapa (ou objeto JSON) com os atributos.
{"X-AUTH-TOKEN":"eyJhbGMiJ9.eyJzdWIsI..."}
"Conteúdo a ser adicionado no corpo na requisição. O formato é definido pelo recurso a ser requisitado, normalmente JSON.
Para o envio de arquivos, também é possível passar nesse parâmetro um mapa contendo os dados de um arquivo ou utilizar o bloco Objeto para Form-Data / Form-Data Object.
{"id":"123","nome":"Paulo"}
"Endereço (caminho) onde o arquivo será salvo ao realizar uma requisição no formato stream. Deve-se informar o caminho com o nome e extensão do arquivo. É recomendado utilizar o caminho de uma pasta temporária da aplicação (exemplo Pasta reciclável da aplicação), evitando manter arquivos obtidos pela aplicação no servidor.
Esse campo deve ser utilizado quando o retorno for um array de bytes referente a um arquivo.
/home/cronapp/project/src/
"Define o retorno do bloco.
Se o status da requisição for maior ou igual a 400, a opção "Body" retornará a mensagem de erro apenas se ela existir. Para retornar todo o erro, utilize a opção "Tudo" ou "Stream" no parâmetro Tipo de resposta. |
A função abaixo inicia criando um mapa contendo o atributo "X-AUTH-TOKEN", usado para autenticação, na variável "autenticacao". Em seguida, faz uma requisição GET em um serviço web e utiliza a entrada Parâmetros para realizar um filtro do tipo query string, no parâmetro Cabeçalho da requisição inclui a variável de "autenticacao". O conteúdo obtido pela requisição é impresso no Console do Depurador (Figura 2).
Endereço montado na requisição da figura 1: https://minhaapi.com.br/users?id=82
Figura 2 - Exemplo de requisição utilizando o bloco Obter conteúdo da URL
Também é possível realizar uma requisição que retorna um array de bytes de arquivo.
O exemplo abaixo faz uma requisição que retorna um arquivo (logo.svg
), usamos o parâmetro Caminho do arquivo (destaque 1 da figura 3) para informar o local onde será salvo este conteúdo "Pasta da aplicação/Cronapp.svg
" e definimos o Tipo da resposta como "Stream" (destaque 2 da figura 3). O resultado da execução do bloco pode ser visto no destaque 3 da figura 3.
No formato "Stream", o bloco Obter conteúdo da URL não retorna valores, apenas executa a ação e salva o arquivo obtido no endereço informado no parâmetro Caminho do arquivo.
Ao gerar algum erro na requisição, essa informação será salva no arquivo informado no parâmetro Caminho do arquivo. Nesses casos, recomendamos renomear a extensão do arquivo para *.txt e abrir em um editor de texto para identificar o problema.
Figura 3 - Exemplo de requisição com array de bytes
Mostraremos agora como realizar uma requisição de envio (POST) com arquivos.
No exemplo da figura 4, obtemos um arquivo enviado pelo usuário da aplicação com o uso do bloco Upload de arquivos e encaminhamos esse arquivo para um recurso em uma API qualquer. Independente da configuração feita no parâmetro Múltiplo do bloco Upload de arquivos (destaque 1 da figura 4), ele sempre retornará uma lista com os endereços dos arquivos, dessa forma, utilizamos o bloco Na lista para obter o endereço desse array e incluí-lo em um mapa, cujo nome da chave foi criado como "file" (2). Foi necessário criar um mapa pois o parâmetro Dados para postagem sempre espera receber um mapa ou JSON.
Utilizamos o bloco Obter conteúdo da URL e configuramos o parâmetro Método da requisição como "POST", no Endereço URL informamos o recurso que espera receber o arquivo e no parâmetro Dados para a postagem incluímos o mapa com o arquivo obtido do bloco Upload de arquivo.
Se não ocorrer nenhum problema durante o processo de requisição, o retorno do bloco Obter conteúdo da URL será "200", pois o parâmetro Tipo da resposta está configurado com a opção "Status".
Figura 4 - Exemplo de requisição POST com o uso de arquivo
Também é possível enviar arquivos informando outros parâmetros de uma requisição "multipart/form-data", acesse a documentação do bloco Objeto para Form-Data para mais detalhes. |
No Cronapp, requisições REST também podem ser tratadas pela Fonte de dados, acesse a documentação Fonte de dados tipo Web Service (REST / SOAP) para mais detalhes.
Nesta página