Obter conteúdo da URL
Obtém o conteúdo de um endereço URL em resposta a uma solicitação HTTP.
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | String | Método de requisição |
| Parâmetro 2 | String | Tipo do conteúdo |
| Parâmetro 3 | String | Endereço URL a ter conteúdo obtido |
| Parâmetro 4 | Mapa | Parâmetros a serem utilizados como filtros da requisição |
| Parâmetro 5 | Mapa | Mapa com cabeçalho a ser adicionado a requisição |
| Parâmetro 6 | Mapa | Mapa com o corpo a ser adicionado a requisição |
| Parâmetro 7 | String | Endereço e nome do arquivo. Esse campo deve ser utilizado quando o retorno for um array de bytes referente a um arquivo. |
| Aviso |
|---|
A partir da versão do |
Retorno
Retorna uma String com o conteúdo da URL.
Compatibilidade
Servidor
Exemplo 1
A função abaixo faz uma requisição GET em um serviço web e utiliza a entrada Parâmetros para realizar um filtro. O conteúdo obtido pela requisição é impresso no Console do Depurador.
Figura 1 - Exemplo de requisição utilizando o bloco Obter conteúdo da URL
Exemplo 2
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.img), usamos o parâmetro Caminho do arquivo (destaque 1 da figura 2) para informar o local onde será salvo este conteúdo "Pasta da aplicação/logo-Cronapp.png" (destaque 2 da figura 2).
Figura 2 - Exemplo de requisição com array de bytes
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 essencialmente 4 métodos diferentes:
| Expandir | ||
|---|---|---|
| ||
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 um 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- O método HEAD- O método OPTIONS- O método TRACE- O método |
Figura 3 - Métodos de Requisição
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 escapados 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 | ||
|---|---|---|
| ||
Figura 4 - Tipos de conteúdo