Obter conteúdo da URL
Obtém o conteúdo de um serviço a partir da sua URL.
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 do serviço a ser obtido |
Parâmetro 4 | Mapa | Objeto com atributos a serem tratados pelo serviço. É necessário passar um objeto JSON com os atributos. |
Parâmetro 5 | Mapa | Mapa com cabeçalho a ser adicionado a requisição. É necessário passar um objeto JSON com objetos para cada Cabeçalho. |
Parâmetro 6 | Mapa | Mapa com o corpo a ser adicionado a requisição |
Retorno
Retorna o conteúdo do serviço REST.
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 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.
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.
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 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 2 - Métodos de Requisição
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.
Mais sobre
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
Os itens mostrados na figura 3 são conhecidos por MIME Type, Clique a aqui para saber mais sobre.
Figura 3 - Tipos de conteúdo