Query params, headers e basic auth

Query params

Query params são elementos importantes ao fazer solicitações HTTP a serviços externos. Eles são usados para transmitir informações específicas no URL de uma solicitação. Os parâmetros podem ser usados para enviar dados como filtros ou qualquer outra informação necessária para personalizar uma solicitação.

Como Usar os Query params

Para usar os parâmetros no Conector HTTP, siga estas etapas:

1. Dentro do Conector HTTP, localize a seção de "Query params".

2. Adicione os parâmetros necessários para sua solicitação HTTP. Cada parâmetro consiste em uma chave (nome) e um valor.

Por exemplo, se você estiver fazendo uma solicitação GET para uma API de previsão do tempo e desejar passar o parâmetro "país" com o valor "Brasil", você configuraria isso da seguinte maneira:

• Chave (Key): país

• Valor (Value): Brasil

O Conector HTTP cuidará de incorporar esses parâmetros à sua solicitação HTTP.

Exemplo de Uso de Parâmetros

Suponha que você deseje buscar informações de previsão do tempo para a cidade de São Paulo usando uma API externa. Se a API esperar o parâmetro "cidade", você configuraria seu Conector HTTP da seguinte maneira:

• Chave (Key): país

• Valor (Value): Brasil

Isso resultará em uma solicitação HTTP que incluirá: https://api.externa.com/previsao?pais=%C3%3o%2Brasil.

Headers

Os headers, são partes importantes de uma solicitação ou resposta HTTP. Eles contêm informações cruciais que definem como a solicitação ou resposta deve ser tratada pelo servidor ou pelo cliente. Os cabeçalhos podem incluir informações como autenticação, tipo de conteúdo, formato de codificação, entre outros.

Como usar headers

Para usar cabeçalhos no Conector HTTP, siga estas etapas:

1. Dentro do Conector HTTP, localize a seção "Headers".

2. Adicione os headers necessários para sua solicitação HTTP. Cada header consiste em uma chave (nome) e um valor.

Por exemplo, se você estiver fazendo uma solicitação POST para uma API que requer autenticação via header "Authorization", você configuraria isso da seguinte maneira:

• Chave (Key): Authorization

• Valor (Value): Bearer <seu-token-de-autenticação>

O Conector HTTP incorporará esses headers à sua solicitação HTTP, garantindo que a API externa os reconheça e processe corretamente.

Exemplo de Uso de Headers

Suponha que você esteja integrando-se a uma API de mídia social que requer autenticação por meio de um token JWT no header "Authorization". Você configuraria seu Conector HTTP da seguinte maneira:

• Chave (Key): Authorization

• Valor (Value): Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Isso garantirá que sua solicitação seja autenticada corretamente pela API de mídia social.

Basic Auth

A funcionalidade de Basic Auth é usada para autenticar solicitações HTTP em serviços que requerem um nome de usuário e senha.

O basic é usado quando a requisição requer uma basic auth, ou atenticação basica, que é através de um usuário e uma senha, passando esses dados no basic a plataforma transforma isso em um basic token que é o mesmo que pegar um usuário e senha e converter em base64.

Esse dado depois de convertido vai no header da requisição para autenticar a chamada.

Por exemplo, se você tiver um nome de usuário "user123" e uma senha "senha456", a representação em base64 das credenciais seria "dXNlcjEyMzpzZW5oYTQ1Ng==". Portanto, você configuraria o header da seguinte maneira:

• Chave (Key): Authorization

• Valor (Value): Basic dXNlcjEyMzpzZW5oYTQ1Ng==