CGWebRequestClient

De CIGAM WIKI

CGWebRequest Client

O CGWebRequest Client é uma ferramenta destinada à criação, ao envio e à validação de requisições. Com ele, é possível configurar métodos HTTP, URLs, parâmetros de query, headers, bodies, tempo de requisição e variáveis reutilizáveis, além de visualizar o código de status, o conteúdo e os headers das respostas.

Abaixo, detalhamos cada uma de suas funcionalidades para guiar a utilização correta da aplicação.

Tela inicial

Ao iniciar, o CGWebRequest exibirá uma janela completa dividida em 3 sessões principais, além do menu superior. O painel mais à esquerda exibe a coleção ativa e permite a criação de novas requisições. O painel superior à direita exibe detalhes da requisição atualmente selecionada, enquanto o painel inferior à direita exibe informações sobre a resposta da requisição atual, se houver.

A largura ou a altura desses painéis pode ser modificada pelo usuário ao parar o mouse na linha que as divide, clicar e arrastar. Isso pode facilitar a visualização em casos onde há muita informação relevante na tela.

Coleção

Nesse painel, ficam exibidas de forma simplificada, todas as requisições criadas pelo usuário em forma de tabela. Em uma das colunas, é exibido o verbo selecionado para cada requisição (que pode ser alterado a qualquer momento) e na outra é exibido o nome da requisição, que pode ser personalizado pelo usuário.

Verbo

Para escolher ou alterar o verbo de uma requisição basta clicar na seta que fica no lado direito da caixa de seleção na coluna verb no painel da coleção. Uma lista com os verbos disponíveis será exibida, então basta selecionar o desejado. Note-se que cada um deles possui uma cor específica, facilitando a visualização e compreensão. Os verbos disponíveis são:

  • GET: Azul
  • POST: Verde
  • PUT: Amarelo
  • DELETE: Vermelho
  • PATCH: Roxo
  • HEAD: Rosa
  • OPTIONS: Marrom
  • PROPFIND: Bege

Nome

A coluna request da tabela permite a personalização do nome da requisição. Para adicionar um nome ou editá-lo, basta dar dois cliques na linha em questão, o que habilitará o cursor para digitação.

Adicionar

Para adicionar uma nova requisição basta selecionar a última linha da tabela de requisições e personalizá-la com o verbo e o nome desejados. Sempre que o usuário modifica essa última linha, o programa automaticamente cria a próxima linha em branco.

Clicar com o botão direito em alguma requisição irá exibir um menu flutuante com 3 opções:


  • Duplicate: Essa opção duplica a requisição selecionada, criando uma igual na última linha da tabela.
  • Delete: Essa opção exclui a requisição selecionada.
  • Exportar Curl: Essa opção exibe uma janela com a requisição selecionada formatada no padrão cURL. Para mais detalhes veja link.