Hoppa till innehåll
100% lokalt

OpenAPI till Postman-samling

Omvandlar ett OpenAPI- eller Swagger-dokument till en Postman v2.1-samling som är redo att importeras.

Inmatning
Utmatning

OpenAPI till Postman-samling

Klistra in ett OpenAPI 3- eller Swagger 2-dokument – JSON eller YAML – och det här verktyget bygger en Postman v2.1-samling som du kan importera direkt i Postman, Insomnia eller vilken annan klient som helst som läser formatet. Varje operation i specifikationen blir en begäran, organiserad i mappar så ett stort API förblir navigerbart istället för att landar som en platt lista.

Gruppera begärandena efter tagg eller efter det första vägsegmentet, vilket som helst passar hur ditt team redan tänker på API:et. Slå på "Infoga bas-URL som miljövariabel" för att byta server-URL:en för en {{baseUrl}}-variabel, så att byta mellan staging och produktion blir en enda miljöändring istället för att redigera varje begäran. "Lägg till auth-headers från säkerhetsschemat" läser specifikationens bärare-, API-nyckel- eller OAuth2-definitioner och lägger till motsvarande Authorization- eller nyckel-header som en platshållare. "Generera exempelbegärandeorgan från scheman" bygger ett JSON-exempel för varje begäran från dess schema, följer $ref-referenser i dokumentet, så POST- och PUT-begärandena anländer förifyllda istället för tomma. Frågeparametrar kan inkluderas med sina beskrivningar, föråldrade slutpunkter kan hoppa över helt, och ett grundläggande testskript som kontrollerar en framgångsrik statuskod kan läggas till varje begäran.

Vägsparametrar som {id} blir automatiskt Postmans :id-vägsvariabler, och CRLF- och LF-radbrytningar i ett inklistrat dokument behandlas samma. Stora specifikationer med hundratals operationer konverteras i ett pass; om samlingen skulle överskrida utgränsen rapporterar det det istället för att frysas fliken.

Allt sker lokalt i din webbläsare – dokumentet du klistrar in, inklusive alla interna API-detaljer det innehåller, laddas aldrig upp någonstans. När samlingen är klar kan du kopiera den, ladda ner den som en fil eller skicka den till ett annat verktys inmatning för att fortsätta arbeta på den.

FAQ

Stöder det både OpenAPI 3 och Swagger 2-dokument?
Ja. Det läser OpenAPI 3:s "servers" och "components.securitySchemes" såväl som Swagger 2:s "host"/"basePath"/"schemes" och "securityDefinitions", och accepterar både JSON och YAML.
Vilka säkerhetssystem känner det igen?
HTTP-bärare och grundläggande auth, API-nycklar i en rubrik, frågeparameter eller cookie, och OAuth2/OpenID Connect — varje mappar till motsvarande platshållar-rubrik eller frågeparameter.
Hur genereras exempelbegärandekroppar?
Från begärans egna "example" eller "default" värden där de förekommer, med återfall till en typlämplig platshållare — $ref-referenser löses upp i samma dokument.
Vad händer med $ref som pekar utanför dokumentet?
De löses till null i det genererade exemplet snarare än att följas någonstans — ingenting i det här verktyget gör någonsin en nätverksbegäran.
Laddas mitt API-dokument upp någonstans?
Nej. Konverteringen körs helt i din webbläsare — dokumentet och allt i det förblir på din enhet.