Histórico da Página

Obter conteúdo da URL

Obtém o conteúdo de um endereço URL em resposta a uma solicitação HTTPserviço a partir da sua URL.

Parâmetros de Entrada

Retorno

Retorna uma string com o conteúdo da URLdo serviço REST.

Compatibilidade

Image Removed Servidor

 Cliente

Exemplo

A função abaixo em destaque faz uma requisição GET ao endereço URL delimitado pelos filtros enviados no corpo da requisição, através do campo Dados para postagem.Image Removed"ObterConteudo" (Figura 1) solicita os dados da URL, por meio do Método de requisição GET, em seguida o campo URL address recebe o endereço da URL a ser requisitado, No campo Parâmetros é passado um objeto por meio do bloco Criar objeto, com o atributo id que será recebido pelo serviço, que então filtrará um usuário. Em Cabeçalho da requisição é passado um objeto com um Token de autorização. Por fim, tem-se o Retorno da variável "item" tanto em caso Sucesso quanto em Erro.

Image Added

Figura 1 - Obtendo conteúdo da URL

Caso seja um Sucesso, imprime a variável de retorno "item" no console do navegador para validar o funcionamento (Figura 1.1) ou, caso dê Erro, o "item" será impresso com a mensagem de Erro.

O endereço da URL passado no campo URL address trata-se de um Web service REST e neste exemplo, ele retorna um objeto JSON. 

Image Added

Figura 1.1 - Retornando no console do browser

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.

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.

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. 

Sobre os métodos de requisição

A obtenção de cabeçalhos do URL pode ser feito utilizando essencialmente 4 os métodos diferentes:

• 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.

Image Added

Figura 2

Image Removed

Figura 1 - 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 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.

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

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.

Image Removed

Os itens mostrados na figura 3 são conhecidos por MIME Type, Clique a aqui para saber mais sobre.

Image Added

Figura 3 Figura 2 - Tipos de conteúdo