Tempo aproximado para leitura:00:09:50 min
Dúvida
Como utilizar a atividade Executar Requisição HTTP
Ambiente
Cross Segmentos - Backoffice RM - Integração - Todas as versões.
Solução
A atividade “Executar Requisição HTTP” permite que a fórmula visual execute uma requisição utilizando o protocolo HTTP(S). Esta requisição de ser feita utilizando qualquer método HTTP (GET, POST, ETC) e permite que os dados retornados pela requisição (em formato binário ou texto) sejam consumidos pela fórmula.
É possível ainda definir o tipo de autenticação da requisição que pode ser básica (informando um usuário e senha) ou baseada em Tokens (informando o schema e token).
Para utilizar a atividade, siga os seguintes passos:
Este documento tem por objetivo especificar a atividade “Executar Requisição HTTP” disponível na Fórmula Visual.
Parâmetros da requisição:
- Endereço da requisição:
Informe o endereço do servidor para executar a requisição. O endereço deve ser informado completo inclusive com o protocolo que pode ser HTTP ou HTTPS. É possível criar parâmetros para montagem do endereço, informando os valores entre <>.
Exemplo:https://www.google.com/search?q=<texto>
Neste caso será criada uma propriedade dinâmica para que seja informado o conteúdo do parâmetro <texto>.
- Métodos de requisição:
Selecione o método HTTP que será utilizado para fazer a requisição, os métodos disponíveis são Get, Head, Post, Put, Delete e Patch. - Tempo Limite:
Informe um tempo limite para execução da requisição em segundos. Caso este tempo seja ultrapassado será gerado um erro de timeout. - Utilizar Proxy do sistema:
Selecione se a requisição deverá utilizar a configuração padrão de proxy do Windows.
Conteúdo da Requisição:
Informe somente uma das propriedades caso deseje enviar algum conteúdo pela requisição, que pode ser binário, post ou texto.
- Dados (Binário)
Informe o conteúdo da requisição em formato binário. Adicionalmente o tipo de conteúdo poderá ser definido através da propriedade “Tipo de Conteúdo da Requisição”.
- Dados (Post)
Informe os nomes dos parâmetros do Post, normalmente esta opção será utilizada quando o método de requisição for Post. Você deve informar um parâmetro por linha e para cada parâmetro informado será criada uma propriedade dinâmica para que o valor seja informado.
- Dados (Texto)
Informe o conteúdo da requisição em formato texto. Adicionalmente o tipo de conteúdo poderá ser definido através da propriedade “Tipo de Conteúdo da Requisição”.
Segurança/Autenticação:
- Tipo de Autenticação
Selecione o tipo de autenticação da requisição, que pode ser:-
None
Não utiliza nenhum tipo de autenticação. -
Basic
Faz a requisição utilizando autenticação básica através de um usuário e senha, que devem ser informados nas propriedades Usuário e Senha.
Para mais informações consulte:
https://pt.stackoverflow.com/questions/254503/o-que-%C3%A9-basic-auth -
Token
Faz a requisição utilizando autenticação via Token (através do Header Authorization), que devem ser informados nas propriedades Token e Token Schema.
Para mais informações consulte:
https://pt.wikipedia.org/wiki/OAuth
-
None
- Usuário:
Informe o nome do usuário que será utilizado pela autenticação básica. - Senha:
Informe a senha do usuário que será utilizado pela autenticação básica. - Token:
Informe os dados do Token que será utilizado pela autenticação via Token. - Token Schema:
Informe o Schema do Token que será utilizado pela autenticação via Token. São exemplos de schema BEARER, OASIS e outros.
Tipo de conteúdo:
- Nome:
Descrição - Codificação do Texto da Requisição:
Informe o tipo de codificação utilizado para codificar/decodificar os textos da requisição. Por padrão será utilizado a formato UTF-8.
Para mais informações consulte:
https://msdn.microsoft.com/pt-br/library/system.text.encoding(v=vs.110).aspx - Tipo de Conteúdo Aceito:
Informe o tipo de conteúdo MIME aceito como retorno da requisição. Por padrão será aceito qualquer tipo de conteúdo, porém alguns servidores Web exigem que o tipo de conteúdo aceito seja informado através do Header HTTP Accept.
Para mais informações consulte:
https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Accept - Tipo de Conteúdo da Requisição:
informe o tipo de conteúdo MIME que será enviado nos dados da requisição. Por padrão o sistema irá utilizar o tipo “application/x-www-form-urlencoded”.
Para mais informações consulte:
https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Type
Resposta:
As propriedades de resposta contêm os dados retornados pela execução da requisição.
- Nome do Parâmetro:
Descrição do Parâmetro (OBRIGATÓRIO) - Resposta (Binário):
Contém o conteúdo da resposta da requisição no formato binário. (NÃO) - Resposta (Código):
Contém o código HTTP da resposta do servidor. (NÃO) - Resposta (Texto):
Contém o conteúdo da resposta da requisição no formato de texto, caso o tipo da resposta (Content-Type: “text”), em formato texto.
0 Comentários