Przejdź do głównej zawartości

Generowanie kodu i eksport specyfikacji API

Przechwycone żądania nie służą tylko do oglądania, mogą od razu stać się gotowym produktem: pojedyncze żądanie zamienia się jednym kliknięciem w uruchamialny kod (5 języków), cała sesja scala się w porządną specyfikację API (OpenAPI), albo eksportuje do uniwersalnego formatu wymiany HAR. Wszystko pochodzi wprost z prawdziwych przechwyceń: bez ręcznego przepisywania, bez pisania od zera. Sesje przechwycone gdzie indziej również można tu zaimportować i przeanalizować.


1. Generowanie kodu: zamień pojedyncze żądanie w uruchamialny kod

Dział zatytułowany „1. Generowanie kodu: zamień pojedyncze żądanie w uruchamialny kod”

Przechwyciłeś żądanie, które chcesz odtworzyć albo udostępnić? Zamień je jednym kliknięciem w gotowy do uruchomienia kod, a potem wklej go w terminalu, dodaj do projektu albo wyślij współpracownikowi.

5 form, przełącz język, aby błyskawicznie wygenerować kod na nowo, skopiuj jednym kliknięciem:

  • cURL (wklej w terminalu i działa)
  • Python
  • JavaScript
  • Go
  • OkHttp (Java / Kotlin)

Wygenerowany kod jest kompletny: metoda żądania, URL, wszystkie nagłówki oraz treść. Nagłówki zachowują oryginalną kolejność i wszelkie duplikaty, wiernie odwzorowując kolejność i powtórzone wpisy, dzięki czemu to, co się uruchamia, wiernie odpowiada prawdziwemu żądaniu i jest gotowe do użycia bez zmian.

Generowanie kodu: przełączanie między cURL / Python / JavaScript / Go / OkHttp, kompletne z metodą, nagłówkami i treścią, kopiowanie jednym kliknięciem

Zwykłe narzędzia często zmieniają kolejność i usuwają duplikaty nagłówków przy generowaniu kodu, przez co odtworzenie odbiega od oryginału; tutaj są zachowane dokładnie, więc to, co się uruchamia, odpowiada prawdziwemu żądaniu.

Skąd generować

  • Lista przechwyceń: kliknij prawym przyciskiem dowolne żądanie, a następnie „Generuj kod…“.
  • Kompozytor: po dopracowaniu żądania w widoku Komponowanie i odtwarzanie kliknij „Generuj kod“.

Kiedy używać: odtworzenie prawdziwego przechwyconego żądania w skrypcie lub projekcie; wyeksportowanie żądania jako kodu po tym, jak zaczęło działać w kompozytorze, a następnie dalsze rozwijanie; udostępnienie pojedynczego żądania współpracownikowi (każdy może uruchomić linijkę cURL).


Przechwyciłeś kawałek ruchu API i chcesz porządną specyfikację? Aplikacja automatycznie porządkuje te żądania, scala je w listę punktów końcowych i jednym kliknięciem generuje dokument OpenAPI, bez pisania ręcznie.

  • Najpierw analiza, potem eksport: aplikacja automatycznie wykrywa punkty końcowe z bieżącej sesji i wypisuje je do sprawdzenia, dzięki czemu eksportujesz tylko to, co wybierzesz, i unikasz szumu. Lista pokazuje wprost dla każdego punktu końcowego metodę, ścieżkę, liczbę wystąpień oraz zaobserwowane kody statusu, dając jasny obraz na pierwszy rzut oka.
  • Automatyczne scalanie ścieżek: aplikacja szablonizuje ścieżki z konkretnymi identyfikatorami, na przykład /users/123 staje się /users/{id}, scalając wiele żądań do tego samego punktu końcowego w jedno.
  • Automatyczne wnioskowanie struktury: scala strukturę JSON żądań / odpowiedzi, grupuje odpowiedzi według kodu statusu i porządkuje zmienne ścieżki w parametry.
  • Tworzy standardowe OpenAPI 3.0: skopiuj lub pobierz dokument, a następnie zaimportuj go do dowolnego narzędzia zgodnego z OpenAPI, aby pracować dalej.

Eksport OpenAPI: zaznacz punkty końcowe po lewej (metoda / ścieżka / liczba wystąpień / kody statusu), po prawej podgląd na żywo automatycznie wywnioskowanej specyfikacji OpenAPI 3.0

Kiedy używać: po przechwyceniu ruchu API szybko stworzyć gotowy do dostarczenia, importowalny dokument OpenAPI; praca analityczna, integracja z zewnętrznymi API, uzupełnianie dokumentacji dla zespołu backendu albo budowanie przypadków testowych dla QA.


3. Import i eksport: współpraca z innymi narzędziami

Dział zatytułowany „3. Import i eksport: współpraca z innymi narzędziami”

Przechwycony ruch nie jest tu zamknięty, a ruch przechwycony gdzie indziej można tu wciągnąć. Jeden standardowy format wymiany sesji łączy oba kierunki:

  • Eksport HAR: wyeksportuj całe przechwycenie do standardowego pliku HAR 1.2 jednym kliknięciem, na potrzeby dostarczenia, archiwizacji albo przekazania innemu narzędziu do dalszej analizy.
  • Import sesji przechwyconych przez innych: zaimportuj zewnętrzne pliki sesji przechwyceń (HAR 1.2, .pcap / .pcapng oraz pliki sesji eksportowane przez popularne narzędzia do przechwytywania), aby wciągnąć pakiety przechwycone przez kogoś innego, obejrzeć je, porównać i wyeksportować.

Kiedy używać: wciągnij ruch przechwycony na produkcji, przez współpracownika albo przez inne narzędzia i analizuj go dalej tutaj przy pomocy dekoderów, profili hostów i porównywania żądań; albo wyeksportuj kawałek ruchu przechwyconego tutaj do uniwersalnego formatu na potrzeby dostarczenia.


Powrót do Przechwytywanie przez proxy · Powiązane: Komponowanie i odtwarzanie · Podgląd i dekodowanie