Construtor de Requisições#

Construtor de Requisições — ferramenta que permite configurar uma requisição REST em uma janela separada e adicionar automaticamente ao diagrama do projeto um bloco pronto "REST Client".

Para abrir o construtor de requisições, é necessário clicar no botão "Construtor de Requisições" no painel "Desenvolvimento" no menu "Avançado".

A janela pop-up "Request constructor" contém os seguintes elementos:

  • lista suspensa com métodos — permite selecionar o tipo de requisição HTTP: Get, Post, Put, Patch, Delete, Head ou Options;
  • botão "Request" — permite formar ou enviar a requisição com as configurações atuais;
  • botão "To block" — permite adicionar a requisição configurada ao projeto como um bloco pronto no diagrama;
  • tabela "Params" com colunas:
    • coluna "On/Off" — permite ativar ou desativar o parâmetro;
    • coluna "Key" — exibe o nome do parâmetro;
    • coluna "Value" — exibe o valor do parâmetro;
  • botão "Save as..." — salva a configuração atual da requisição em um arquivo ou modelo;
  • botão "Load from..." — carrega a configuração da requisição salva anteriormente;
  • botão "Bulk Edit" — permite editar os parâmetros em lista;
  • campo "RESPONSE" — permite visualizar a resposta do servidor após a execução da requisição.

Aba Headers#

Na janela "Request constructor", na aba "Headers", há uma tabela destinada à configuração dos cabeçalhos HTTP da requisição.

A tabela inclui as seguintes colunas:

  • coluna "On/Off" — checkboxes para ativar os cabeçalhos, que permitem ativar ou desativar um cabeçalho específico sem removê-lo da lista;
  • coluna "Key" — chaves dos cabeçalhos HTTP (por exemplo, "Content-Type" ou "Authorization");
  • coluna "Value" — valores dos cabeçalhos correspondentes às chaves (por exemplo, "application/json" para Content-Type).

Aba Body#

Na janela "Request constructor", na aba "Body", há flags que definem o formato dos dados enviados no corpo da requisição HTTP:

  • flag "none" — se o corpo da requisição estiver ausente;
  • flag "form-data" — para enviar a requisição com arquivos e texto;
  • flag "x-www-form-urlencoded" — para enviar dados simples de login ou senha no corpo da requisição;
  • flag "raw" — para entrada manual de texto no corpo da requisição;
  • flag "Clear Body" — para redefinir completamente o corpo da requisição.

Aba Proxy#

Na janela "Request constructor", na aba "Proxy", há uma tabela onde são definidas as configurações do servidor proxy para roteamento da requisição.

A tabela inclui as seguintes colunas:

  • coluna "On/Off" — checkboxes para ativar o proxy, que permitem ativar ou desativar o proxy sem remover as configurações;
  • coluna "Address" — endereços dos servidores proxy no formato host:port, que indicam para onde direcionar o tráfego;
  • coluna "Type" — tipos de proxy (HTTP, HTTPS, SOCKS4, SOCKS5);
  • coluna "Username" — nomes de usuários para autenticação no proxy (se necessário);
  • coluna "Password" — senhas para o servidor proxy.

Aba Settings#

Na janela "Request constructor", na aba "Setting", são configurados os parâmetros gerais de execução da requisição:

  • campo "Timeout" — tempo máximo de espera pela resposta em segundos;
  • campo "Max Automatic Redirections" — número máximo de vezes que a requisição pode ser redirecionada automaticamente para um novo endereço;
  • checkbox "Enable SSL certificate verification" — verificação do certificado SSL do servidor;
  • checkbox "PreAuthenticate" — pré-autenticação. Ao preenchê-lo, dois campos adicionais são ativados:
    • campo "User" — login que é enviado no cabeçalho Authorization;
    • campo "Password" — senha que é enviada no cabeçalho Authorization.