OpenAPI u Postman kolekciju
Pretvori OpenAPI ili Swagger dokument u Postman v2.1 kolekciju koja je spremna za uvoz.
OpenAPI u Postman kolekciju
Zalijepite OpenAPI 3 ili Swagger 2 dokument — JSON ili YAML — i ovaj alat pravi Postman v2.1 kolekciju koju možete direktno uvoziti u Postman, Insomniu ili bilo koji drugi klijent koji podržava taj format. Svaka operacija iz specifikacije postaje zahtjev, organiziran u mape tako da velika API ostaje navigabilna umjesto da se pojavi kao jedan flat popis.
Grupirajte zahtjeve po oznakama ili po prvom segmentu putanje, ovisno o tome što bolje odgovara načinu na koji vaš tim već razmišlja o API-ju. Uključite "Umetni bazni URL kao varijablu okruženja" kako biste zamijenili URL servera s varijablom {{baseUrl}}, tako da prebacivanje između testnog i produkcijskog okruženja bude samo jedna promjena varijable umjesto uređivanja svakog zahtjeva. "Dodaj zaglavlje autentifikacije iz sheme sigurnosti" čita specifikacijske definicije nositelja, API ključa ili OAuth2 i dodaje odgovarajuće Authorization ili ključno zaglavlje kao rezervu. "Generiraj primjere tijela zahtjeva iz shema" pravi JSON primjer za svaki zahtjev iz njegove sheme, prateći reference u dokumentu, tako da POST i PUT zahtjevi stignu unaprijed popunjeni umjesto prazni. Parametri upita mogu biti uključeni s njihovim opisima, zastarjele krajnje točke se mogu potpuno preskočiti, a osnovni test skriptu koji provjerava uspješan statusni kod može se dodati svakom zahtjevu.
Parametri putanje kao {id} automatski postaju Postmanove :id varijable, a CRLF i LF završni znakovi reda u zalijepljenom dokumentu tretiraju se jednako. Velike specifikacije sa stotinama operacija konvertuju se u jednom prolazu; ako bi kolekcija premašila granicu izlaza, alat će to prijaviti umjesto da zamrzne karticu.
Sve se događa lokalno u vašem pregledniku — dokument koji zalijepite, uključujući sve interne detalje API-ja koje sadrži, nikada se ne šalje nigdje. Kada je kolekcija spremna, možete je kopirati, preuzeti kao datoteku ili je poslati kao ulaz drugom alatu kako biste nastavili s radom na njoj.