Ga naar inhoud
100% lokaal

OpenAPI naar Postman-verzameling

Converteert een OpenAPI- of Swagger-document naar een Postman v2.1-verzameling die klaar is voor import.

Invoer
Uitvoer

OpenAPI naar Postman-verzameling

Plak een OpenAPI 3- of Swagger 2-document – JSON of YAML – en deze tool bouwt een Postman v2.1-verzameling die je direct in Postman, Insomnia of elke andere client kunt importeren die het formaat ondersteunt. Elke operatie in de spec wordt een verzoek, georganiseerd in mappen zodat een grote API navigeerbaar blijft in plaats van als één platte lijst te landen.

Groepeer verzoeken op tag of op het eerste padsegment, wat aansluit bij hoe jouw team de API al denkt. Zet "Basis-URL als omgevingsvariabele invoegen" aan om de server-URL voor een {{baseUrl}}-variabele in te wisselen, zodat schakelen tussen staging en productie een enkele omgevingsverandering is in plaats van elk verzoek aan te passen. "Auth-headers uit het beveiligingsschema toevoegen" leest de bearer-, API-sleutel- of OAuth2-definities van de spec en voegt de overeenkomstige Authorization- of key-header als placeholder toe. "Voorbeeld-request bodies uit schemas genereren" bouwt voor elk verzoek een JSON-voorbeeld uit zijn schema, volgt $ref-verwijzingen in het document, zodat POST- en PUT-verzoeken vooraf ingevuld in plaats van leeg arriveren. Query-parameters kunnen met hun beschrijvingen worden opgenomen, afgeschafte endpoints kunnen geheel worden overgeslagen, en elk verzoek kan een eenvoudig testscript krijgen dat op een geslaagde statuscode controleert.

Padparameters zoals {id} worden automatisch Postmans :id-padvariabelen, en CRLF- en LF-lijnbrekingen in een geplakt document worden hetzelfde behandeld. Grote specs met honderden operaties worden in één keer geconverteerd; als de verzameling de uitvoerlimiet zou overschrijden, wordt dit aangegeven in plaats van het tabblad in te vriezen.

Alles gebeurt lokaal in je browser – het document dat je plakt, inclusief alle interne API-details erin, wordt nergens geüpload. Als de verzameling gereed is, kun je het kopiëren, als bestand downloaden of naar de invoer van een ander tool sturen om er mee door te gaan.

FAQ

Ondersteunt het zowel OpenAPI 3 als Swagger 2 documenten?
Ja. Het leest OpenAPI 3's "servers" en "components.securitySchemes" evenals Swagger 2's "host"/"basePath"/"schemes" en "securityDefinitions", en accepteert zowel JSON als YAML.
Welke beveiligingsschema's herkent het?
HTTP bearer en basic auth, API-sleutels in een header, queryparameter of cookie, en OAuth2/OpenID Connect — elk wordt toegewezen aan de overeenkomstige placeholder-header of queryparameter.
Hoe worden voorbeeld-request bodies gegenereerd?
Uit de eigen "example" of "default" waarden van het requestschema waar aanwezig, met terugval op een type-passende placeholder — $ref-referenties worden in hetzelfde document opgelost.
Wat gebeurt er met $ref's die buiten het document wijzen?
Ze worden opgelost naar null in het gegenereerde voorbeeld in plaats van ergens anders te worden gevolgd — niets in deze tool doet ooit een netwerkverzoek.
Wordt mijn API-document ergens geüpload?
Nee. De conversie loopt volledig in je browser — het document en alles erin blijven op je apparaat.