OpenAPI v Postman zbirko
Pretvori OpenAPI ali Swagger dokument v Postman v2.1 zbirko, ki je pripravljena za uvoz.
OpenAPI v Postman zbirko
Prilepite OpenAPI 3 ali Swagger 2 dokument — JSON ali YAML — in to orodje ustvari Postman v2.1 zbirko, ki jo lahko direktno uvozite v Postman, Insomnia ali katerega koli drugega odjemalca, ki podpira to obliko. Vsaka operacija iz specifikacije postane zahtevek, organiziran v mape, tako da ostane velika API pregledno namesto da bi bila prikazana kot en sam seznam.
Grupirajte zahteve po oznakah ali po prvem segmentu poti, ne glede na to, kaj bolje ustreza načinu, na katerega vaša ekipa razmišlja o API-ju. Vključite "Vstavi osnovni URL kot spremenljivko okolja", da nadomestite naslov URL strežnika s spremenljivko {{baseUrl}}, tako da je preklapljanje med preskusnimi in proizvodnimi okolji samo ena sprememba spremenljivke namesto urejanja vsakega zahtevka. "Dodaj glavo avtentifikacije iz sheme varnosti" bere specifikacijske definicije nosilca, ključa API ali OAuth2 in dodaja ustrezno glavo Authorization ali ključ kot rezervo. "Generiraj primere telesa zahteve iz shem" ustvari primer JSON za vsak zahtevek iz njegove sheme, sledimo referencam znotraj dokumenta, tako da zahtevki POST in PUT pridejo vnaprej izpolnjeni namesto prazni. Parametre poizvedbe je mogoče vključiti z njihovimi opisi, zastarele končne točke je mogoče v celoti preskočiti, in osnovno testno kodo, ki preverja uspešno statusno kodo, je mogoče dodati vsakemu zahtevku.
Parametri poti kot {id} se samodejno spremenijo v Postmanove spremenljivke :id, končnice vrstic CRLF in LF v prilepljeni dokument pa se obravnavajo enako. Velike specifikacije s stotinami operacij se pretvorijo v enem prehodu; če bi zbirka presegla mejno vrednost izhoda, vam to orodje to javi namesto da bi zamrznilo zavihek.
Vse se dogaja lokalno v vašem brskalniku — dokument, ki ga prilepite, vključno z vsemi internimi podrobnostmi API-ja, ki jih vsebuje, nikoli ne bo poslano nikamor. Ko je zbirka pripravljena, jo lahko kopirate, prenesete kot datoteko ali je pošljete kot vhod drugemu orodju, da nadaljujete z delom na njej.