Gerar um arquivo HTTP

O Proxy de Desenvolvimento permite que você gere um arquivo HTTP a partir de solicitações e respostas de API interceptadas. O uso de arquivos HTTP é especialmente útil para desenvolvedores que desejam simular o comportamento da API ou compartilhar interações de API reproduzíveis. O arquivo HTTP inclui todos os detalhes de solicitação e resposta relevantes, com informações confidenciais substituídas por variáveis para segurança e reutilização.

Para gerar um arquivo HTTP usando o Proxy de Desenvolvimento:

1. No arquivo de configuração, habilite o HttpFileGeneratorPlugin:

   {
     "plugins": [
       {
         "name": "HttpFileGeneratorPlugin",
         "enabled": true,
         "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
         "configSection": "httpFileGeneratorPlugin"
       }
     ]
     // [...] shortened for brevity
   }
   

2. Opcionalmente, configure o plug-in:

   {
     "httpFileGeneratorPlugin": {
       "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/httpfilegeneratorplugin.schema.json",
       "includeOptionsRequests": false
     }
     // [...] shortened for brevity
   }
   

   • includeOptionsRequests: determina se as solicitações devem ser incluídas OPTIONS no arquivo HTTP gerado. O padrão é false.

3. No arquivo de configuração, à lista de URLs a serem exibidas, adicione a URL da API para a qual você deseja gerar um arquivo HTTP:

   {
     "urlsToWatch": [
       "https://api.example.com/*"
     ]
     // [...] shortened for brevity
   }
   

4. Iniciar Proxy de Desenvolvimento:

   devproxy
   

5. Inicie a gravação de solicitações pressionando r.

6. Execute as solicitações de API que você deseja incluir no arquivo HTTP.

7. Pare de gravar pressionando s.

8. O Proxy de Desenvolvimento gera um arquivo HTTP e o salva no diretório atual. O arquivo inclui todas as solicitações e respostas capturadas, com dados confidenciais, como tokens de portador e chaves de API substituídas por variáveis. Por exemplo:

   @jsonplaceholder_typicode_com_api_key = api-key
   ###
   # @name getPosts
   GET https://jsonplaceholder.typicode.com/posts?api-key={{jsonplaceholder_typicode_com_api_key}}
   Host: jsonplaceholder.typicode.com
   User-Agent: curl/8.6.0
   Accept: */*
   Via: 1.1 dev-proxy/0.29.0
   

   O plug-in cria automaticamente variáveis para cada combinação de nome de host e parâmetro confidencial, reutilizando-as entre solicitações quando aplicável.

Próximas etapas

Saiba mais sobre o HttpFileGeneratorPlugin.

HttpFileGeneratorPlugin