Udostępnij za pośrednictwem


Generowanie pliku HTTP

Dev Proxy umożliwia generowanie pliku HTTP na podstawie przechwyconych żądań i odpowiedzi interfejsu API. Korzystanie z plików HTTP jest szczególnie przydatne dla deweloperów, którzy chcą symulować zachowanie interfejsu API lub współużytkować powtarzalne interakcje interfejsu API. Plik HTTP zawiera wszystkie istotne szczegóły żądania i odpowiedzi, a poufne informacje zastąpione zmiennymi na potrzeby zabezpieczeń i możliwości ponownego użycia.

Aby wygenerować plik HTTP przy użyciu serwera proxy deweloperskiego:

  1. W pliku konfiguracji włącz polecenie HttpFileGeneratorPlugin:

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

    {
      "httpFileGeneratorPlugin": {
        "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.29.2/httpfilegeneratorplugin.schema.json",
        "includeOptionsRequests": false
      }
      // [...] shortened for brevity
    }
    
    • includeOptionsRequests: określa, czy OPTIONS żądania mają być uwzględnione w wygenerowanych plikach HTTP. Wartość domyślna to false.
  3. W pliku konfiguracji do listy adresów URL do obejrzenia dodaj adres URL interfejsu API, dla którego chcesz wygenerować plik HTTP:

    {
      "urlsToWatch": [
        "https://api.example.com/*"
      ]
      // [...] shortened for brevity
    }
    
  4. Uruchom serwer proxy deweloperów:

    devproxy
    
  5. Rozpocznij rejestrowanie żądań, naciskając r.

  6. Wykonaj żądania interfejsu API, które chcesz uwzględnić w pliku HTTP.

  7. Zatrzymaj nagrywanie, naciskając s.

  8. Dev Proxy generuje plik HTTP i zapisuje go w bieżącym katalogu. Plik zawiera wszystkie przechwycone żądania i odpowiedzi, z danymi poufnymi, takimi jak tokeny elementu nośnego i klucze interfejsu API zastąpione zmiennymi. Przykład:

    @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
    

    Wtyczka automatycznie tworzy zmienne dla każdej kombinacji nazwy hosta i poufnego parametru, ponownie korzystając z nich między żądaniami, jeśli ma to zastosowanie.

Zrzut ekranu przedstawiający dwa okna wiersza polecenia. Jeden z nich przedstawia żądania interfejsu API rejestrowania serwera proxy dla deweloperów. Drugi pokazuje wygenerowany plik HTTP.

Dalsze kroki

Dowiedz się więcej o httpFileGeneratorPlugin.