HTTP

objetivo/resumo o conector http é responsável por estabelecer uma conexão entre o cliente e o servidor, enviar solicitações http e receber respostas http o conector também permite o usuário gerenciar a autenticação e segurança durante a comunicação criando um fluxo utilizando conector http para criar um fluxo utilizando um conector de http, dependendo do caso precisaremos criar uma conexão, e configurar a parametrização do fluxo nota não necessariamente precisamos de uma conexão, isso vai depender do servidor que deseja enviar a solicitação criando conexão http obs e acesse nosso passo a passo para saber como criar uma conexão estes são os seguintes parâmetros de configuração da conexão http que serão requisitados na hora da criação nome parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão descrição parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão autenticação http parâmetro usado para referenciar como será a autenticação ao servidor nele temos três tipos basic o cliente envia um cabeçalho de autenticação com seu nome de usuário e senha bearer token o cliente usa tokens de acesso para autenticar solicitações api key o cliente envia um código alfanumérico exclusivo (api key) que identifica o aplicativo e o autoriza a acessar a api aqui temos duas opções de envio, via url ou no cabeçalho oauth2 0 o cliente precisa inserir os dados do aplicativo que pretende se conectar, como client id , client secret , scope e adicionar https //console fluidapi io/ https //console fluidapi io/ como redirect uri no aplicativo também é necessário informar o authorization url e access token url para tratamento das credênciais com isso basta clicar no botão login para liberação do acesso à aplicação oauth1 0 o cliente precisa informar qual será o signature method , consumer key , consumer secret , access token e se necessário o realm do serviço que pretende se conectar bearer token custom um tipo customizado onde é gerado um token via login de usuário e senha, em seguida gerado um outro token junto com um refresh através de uma url de autenticação, e por fim usamos esse token para se autenticar com a api via bearer token também é necessário informar uma url para fazer o refresh do token sempre que ele vencer importante para setar os valores de qualquer autenticação temos duas opções recuperar valor do cache/requisição onde o usuário por exemplo precise fazer uma requisição para obter um bearer token, aqui será preciso informar o caminho onde o valor se encontra usar valor fixo/template onde o usuário pode passar um valor fixo configuração detalhada requisição caso o usuário precise fazer uma requisição para obter um valor de autenticação, e informa lo em uma das opções do campo autenticação http verbo métodos http a serem suportados pelo endpoint post, put, get, patch, delete corpo body da requisição cabeçalho headers a serem enviados para o endpoint url url contendo o endpoint onde será solicitado a requisição cache o cache armazena uma resposta associada a uma solicitação e reutiliza a resposta armazenada para solicitações subsequentes expiração indica ao navegador por quanto tempo ele poderá manter a resposta em cache antes de solicitar uma nova caminho dos valores usado para informar os caminhos dos valores a serem armazenados configurando fluxo http crie um fluxo e arraste o conector http para o canvas obs e acesse nosso passo a passo para saber como criar um fluxo selecione o conector e na aba de parametrização e preencha os seguintes parâmetros de configuração verbo métodos http a serem suportados pelo endpoint post, put, get, patch, delete url url contendo o endpoint onde será solicitado a requisição corpo body da requisição, podendo ser passado através de um de/para ou template cabeçalho headers a serem enviados para o endpoint opções avançadas converter resposta em base64 ao ativar, todo o conteúdo da resposta será convertido em base64 (recomendado usar para trafego de arquivos) nota estes campos podem ser preenchidos usando docid 0vqvpw6saqz2z1jgp8fwc na aba propriedades selecione a conexão desejada, dê um nome ao passo e se necessário detalhe uma descrição envio de arquivos com formdata e base64 habilitado quando o corpo da requisição é configurado como formdata, o conector http envia os dados no formato multipart/form data , permitindo anexar arquivos e campos de texto se a opção converter resposta em base64 estiver habilitada , o comportamento da requisição é o seguinte o envio de arquivos continua sendo realizado como arquivo binário real , com content disposition e content type adequados, simulando o mesmo formato utilizado por ferramentas como postman o campo base64 atua apenas na resposta , convertendo o conteúdo retornado em base64 para facilitar o tráfego e armazenamento de arquivos (por exemplo, pdfs) o destino da requisição recebe o arquivo completo , e não apenas uma string base64 exemplo configuração de corpo { "body" "formdata", "formdata" \[ { "key" "file", "value" "@tmp/foto png" }, { "key" "user id", "value" "12345" } ] } resultado file é enviado como parte de arquivo (content type image/png) user id é enviado como texto o log de saída mostra um envio multipart completo na prática neste tópico será aplicado exemplos de implementações com intuito de mostrar o conector http na prática será criado dois fluxos com cenários diferentes que vai do básico até o avançado cenário 1 get em uma api pública ( https //random data api com/api/v2/user https //random data api com/api/v2/users ) cuja endpoint de acesso retornará dados aleatórios de usuários neste caso não será preciso criar uma conexão pois a api não necessita de autenticação para obter detalhes sobre como criar um fluxo clique em @saiba mais assim ficou as configurações na aba parametrização já na aba propriedades só foi informado o nome do passo pois não será preciso uma conexão para esta requisição http resultado não foi necessário nenhum dado de entrada para execução desse fluxo então após seu disparo teremos as seguintes informações log canvas detalhe canvas fluxo de mensagens entrada não possui dados de entrada saída { "id" 6650, "uid" "23bfa134 b0e4 4407 84fb e767ef90d478", "password" "xbn1ovhpei", "first name" "rodolfo", "last name" "ondricka", "username" "rodolfo ondricka", "email" "rodolfo ondricka\@email com", "avatar" "https //robohash org/explicabovoluptasaccusantium png?size=300x300\u0026set=set1", "gender" "non binary", "phone number" "+49 1 857 602 2194 x997", "social insurance number" "606446524", "date of birth" "1994 12 02", "employment" { "title" "chief marketing producer", "key skill" "work under pressure" }, "address" { "city" "kemmerport", "street name" "ratke crescent", "street address" "180 goyette fork", "zip code" "31754", "state" "indiana", "country" "united states", "coordinates" { "lat" 80 70699007365332, "lng" 71 33432653571457 } }, "credit card" { "cc number" "5557 7812 5583 6356" }, "subscription" { "plan" "premium", "status" "idle", "payment method" "credit card", "term" "annual" } } cenário 2 get em uma api privada ( https //customer cooruja app/v1/customer https //customer cooruja app/v1/customer ) cuja endpoint de acesso retornará dados do usuário logado para isso será necessário criar uma conexão para autenticar conexão obs e acesse nosso passo a passo para saber como criar uma conexão na tela de criação da conexão após selecionado o conector http e informar um nome, selecione o tipo de autenticação neste cenário a api requer uma autenticação via bearer token, após selecionado, temos duas maneiras de informar o valor; usar valor fixo/template onde o usuário ja possui o token (recomendado para token que não possui expiração) recuperar valor do cache/requisição onde o usuário precisa fazer uma requisição antes para recuperar o valor, nesse caso o token para esse cenário será preciso acessar o endpoint de login da api para recuperarmos o valor do token ( https //customer cooruja app/v1/user/auth https //customer cooruja app/v1/user/auth ) e assim usarmos ele para autenticar nossa busca dos dados do cliente então em configurações avançadas > requisição selecione a opção usar requisição e preencha os campos com os seguintes valores a api requer que enviemos um cabeçalho informando o content type em seguida iremos usar a opção cache para armazenar nosso valor e poder reutilizado em outras possíveis solicitações então em configurações avançadas > cache selecione a opção usar cache e preencha os campos com os seguintes valores a expiração indica ao navegador por quanto tempo ele porderá manter a resposta em cache antes de solicitar uma nova neste caso estamos passando um valor fixo (passado em segundos) pois a api não nos retorna o tempo de expiração do token, caso retornasse poderia ser usado a opção recuperar valor do cache/requisição e informar o caminho onde se encontra esse valor em caminho dos valores será informado o caminho onde se encontra o valor do token na resposta da requisição para seu armazenamento, se consultarmos no postman veremos onde se encontra esse valor o token está no campo access token , logo o caminho onde ele se encontra será body access token haja vista que temos uma requisição para buscar o token de autenticação e sabemos o caminho onde o valor esta armazenado, basta informar esse caminho em autenticação http > bearer token > recuperar valor do cache/requisição visão geral da conexão para este cenário fluxo com a conexão pronta agora é só criar e configurar o fluxo para obter detalhes sobre como criar um fluxo clique em @saiba mais assim ficou a configuração na aba parametrização já em propriedades resultado não foi necessário nenhum dado de entrada para execução desse fluxo então após seu disparo teremos as seguintes informações log canvas detalhe canvas fluxo de mensagens entrada não possui dados de entrada saída { "content" { "id" "676d0f3e e7b6 4aa1 a70c 0e4ec23199e7", "namefantasy" "flycam safety4", "cpfcnpj" "30810572052", "email" "teste\@flycam com br", "contact" "84998984867", "whatsapp" true, "address" "rua campo azul", "num" "1", "complement" "prox tre", "latitude" 5 941431, "longitude" 35 260507, "enabled" true, "district" "sonho verde", "city" "parnamirim", "zipcode" "59000000", "uf" "rn", "updatedat" "2023 02 16t03 15 12 381z", "createdat" "2023 01 08t18 31 01 573z" } } configurar opções avançadas selecione se deseja configurar opções mais avançadas para a sua requisição essas configurações são úteis para casos específicos, como depuração ou testes, mas requerem um conhecimento avançado da plataforma ou sobre requisições http modo debug título modo debug (não usar em produção) tipo booleano descrição habilite o modo debug se precisar fornecer mais informações para a fluid depurar algum problema este modo fornece logs detalhados sobre a requisição e a resposta nota importante não deve ser usado em ambientes de produção devido à quantidade de informações sensíveis que podem ser registradas e a quantidade de logs gerados ignorar validação de segurança título ignorar validação de segurança (não usar em produção) tipo booleano descrição ao habilitar esta opção, a requisição aceitará qualquer certificado ssl/tls apresentado pelo servidor, ignorando a validação de segurança isso pode ser útil para testar conexões com servidores que usam certificados autoassinados advertência não deve ser usado em ambientes de produção esta opção reduz a segurança da sua conexão e não deve ser usada em ambientes de produção importância e uso estas configurações avançadas são essenciais para cenários de teste e depuração, mas devem ser usadas com cautela é crucial não ativá las em ambientes de produção para evitar riscos de segurança e garantir o funcionamento adequado de suas integrações ao configurar seu conector http , considere cuidadosamente se estas opções avançadas são necessárias para o seu caso específico e esteja ciente dos riscos envolvidos ao ativá las