Bloco responsável por realizar uma requisição REST a partir do recurso (URL) informado.
Figura 1 - Bloco Obter conteúdo da URL
Obtém o conteúdo de um serviço REST.
Parâmetros de Entrada
Endereço URL a ter conteúdo obtido
| Aviso |
|---|
A partir da versão do |
Retorno
Retorna uma String com o conteúdo da URL.
Compatibilidade
Servidor
Exemplo 1
A função abaixoEndereço montado na requisição da figura 1: https://minhaapi.com.br/users?id=82
Figura 2
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.
Figura 3
Sobre o protocolo HTTP
Hypertext Transfer Protocol (HTTP) é o método utilizado para enviar e receber informações na web. Este protocolo é baseado em requisições e respostas entre clientes e servidores.
| Informações | ||
|---|---|---|
| ||
Sobre URL - Localizador Uniforme de Recursos
Um URL se refere ao endereço de rede no qual se encontra algum recurso a ser acessado, como por exemplo uma página de internet, um arquivo de computador. Este acesso pode ser feito via Internet, por uma rede corporativa (como uma intranet) e etc.
| Informações | ||
|---|---|---|
| ||
Sobre URI - Identificador Uniforme de Recursos
Uniform Resource Identifier (em inglês) é a uma cadeia de caracteres compacta usada para identificar ou denominar um recurso na Internet. O principal propósito desta identificação é permitir a interação com representações do recurso através de uma rede usando protocolos específicos.
| Informações | ||
|---|---|---|
| ||
Sobre os métodos de requisição
A obtenção de cabeçalhos do URL pode ser feito utilizando os métodos:
- GET: solicita uma representação de dados de um recurso específico.
- POST: submete dados a serem processados para um recurso específico.
- PUT: requisita que uma entidade seja armazenada embaixo do URI fornecido. Se o URI se refere a um recurso que já existe, ele é modificado; se o URI não aponta para um recurso existente, então o servidor pode criar o recurso com esse URI.
- DELETE: apaga o recurso especificado.
- PATCH: utilizado para aplicar modificações parciais em um recurso.
- HEAD: solicita uma resposta de forma idêntica ao método
GET, porém sem conter o corpo da resposta. - OPTIONS: usado para descrever as opções de comunicação com o recurso de destino.
- TRACE: executa um teste de chamada loop-back junto com o caminho para o recurso de destino.
Figura 3 - Métodos de Requisição
| Dica |
|---|
Acesse Métodos de requisição HTTP para maiores informações. |
Sobre os tipos de conteúdo
A codificação URL é frequentemente utilizada no envio de formulários web através de uma requisição POST. A codificação padrão empregada nesse envio é a "x-www-form-urlencoded". Este é um formato para codificação de pares chave-valor. Cada par chave-valor é separado por um caractere '&' e cada chave é separada de seu valor por um caractere '='. Chaves e valores são ambos espaçados pela substituição de espaços com o caractere '+' e então utilização de codificação de URL em todos os caracteres não-alfanuméricos.
| Bloco de código | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Os pares chave-valor:
Nome: Jonathan Doe
Idade: 23
Fórmula: a + b == 13%!
são codificados como:
Nome=Jonathan+Doe&Age=23&Formula=a+%2B+b+%3D%3D+13%25%21 |
| Informações | ||
|---|---|---|
| ||
JSON é um acrônimo para "JavaScript Object Notation". Um formato de padrão aberto que utiliza texto legível a humanos para transmitir objetos de dados consistindo de pares chave-valor. É o formato de dados mais comumente utilizado para comunicação assíncrona navegador/servidor.
| Informações | ||
|---|---|---|
| ||
Os itens mostrados na figura 3 são conhecidos por MIME Type, Clique a aqui para saber mais sobre.
Exemplo 3
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
| Dica |
|---|
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. |
Saiba mais
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
| Índice |
|---|