OpenAPI do Postman kolekce
Převeďte dokument OpenAPI nebo Swagger na hotovou kolekci Postman v2.1 k importu.
OpenAPI do Postman kolekce
Vložte dokument OpenAPI 3 nebo Swagger 2 — JSON nebo YAML — a tento nástroj vytvoří kolekci Postman v2.1, kterou můžete importovat přímo do Postmanu, Insomnie nebo libovolného klienta, který tento formát podporuje. Každá operace ve specifikaci se stane požadavkem, organizovaným do složek, aby zůstalo velké API navigovatelné místo toho, aby skončilo jako jeden plochý seznam.
Seskupte požadavky podle značky nebo podle prvního segmentu cesty — podle toho, co lépe odpovídá tomu, jak váš tým o API přemýšlí. Zapněte možnost "Vložit základní URL jako proměnnou prostředí" a nahraďte adresu URL serveru proměnnou {{baseUrl}}, aby byl přechod mezi staging a produkcí změnou jednoho prostředí místo úpravy každého požadavku. "Přidat ověřovací záhlaví ze schématu zabezpečení" přečte definice bearer, API-key nebo OAuth2 ve specifikaci a přidá odpovídající ověřovací nebo key záhlaví jako zástupný symbol. "Generovat ukázkové těla požadavků ze schémat" vytvoří příklad JSON pro každý požadavek z jeho schématu, přičemž sleduje reference $ref v dokumentu, takže požadavky POST a PUT přijdou předvyplněné místo prázdných. Parametry dotazu mohou být zahrnuty s jejich popisy, zastaralé koncové body je možné zcela přeskočit a základní testovací skript kontrolující úspěšný stavový kód lze přidat do každého požadavku.
Parametry cesty jako {id} se automaticky stanou proměnnými cesty Postman :id a řádky s CRLF a LF mají stejné zacházení. Velké specifikace se stovkami operací se konvertují v jednom průchodu; pokud by kolekce překročila limit výstupu, nástroj to oznámí místo zamrznutí záložky.
Všechno se děje lokálně ve vašem prohlížeči — dokument, který vložíte, včetně všech vnitřních detailů API, které obsahuje, se nikdy neodešle nikam. Když je kolekce hotová, můžete ji zkopírovat, stáhnout jako soubor nebo poslat na vstup jiného nástroje, abyste pokračovali v práci.