Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 5 Próxima »

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

NomeTipoDoc
Parâmetro 1StringMétodo de requisição
Parâmetro 2StringTipo do conteúdo
Parâmetro 3String

Endereço URL a ter conteúdo obtido

Parâmetro 4MapaParâmetros a serem utilizados como filtros da requisição
Parâmetro 5MapaMapa com cabeçalho a ser adicionado a requisição
Parâmetro 6MapaMapa com o corpo a ser adicionado a requisição

Retorno

Retorna uma string com o conteúdo da URL.

Compatibilidade

 Cliente

Exemplo

A função ObterConteudo (Figura 1) solicita os dados da URL, por meio do Método de requisição GET, em seguida o Método de requisição application/x-www-form-urlencoded de codificação e em URL address, passa o endereço da URL a ser requisitado. Por fim, retorno a variável "item" e, caso seja um Sucesso, imprime o "item" no console do navegador para validar o funcionamento e o bloco Exibir notificação tipo Sucesso com a mensagem "Ok", caso dê Erro, o item também será impresso e a notificação será do tipo Erro com a mensagem "Erro".


Figura 1 - Obtendo conteúdo da URL


O endereço da URL passado no campo URL adress trata-se de um Web service REST


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.

Mais sobre

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.

Mais sobre

Sobre os métodos de requisição

A obtenção de cabeçalhos do URL pode ser feito utilizando essencialmente 4 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 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.


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


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

Mais sobre


Figura 3 - Tipos de conteúdo

  • Sem rótulos