Convertitore da OpenAPI a collezione Postman
Converti un documento OpenAPI o Swagger in una collezione Postman v2.1 pronta per l'importazione.
Convertitore da OpenAPI a collezione Postman
Incolla un documento OpenAPI 3 o Swagger 2 — in JSON o YAML — e questo strumento costruisce una collezione Postman v2.1 che puoi importare direttamente in Postman, Insomnia o qualsiasi client che legga il formato. Ogni operazione nella specifica diventa una richiesta, organizzata in cartelle per mantenere un'API grande navigabile invece di atterrare come un elenco piatto.
Raggruppa le richieste per tag o per il primo segmento di percorso, a seconda di come il tuo team già pensa all'API. Abilita « Inserisci l'URL di base come variabile di ambiente » per sostituire l'URL del server con una variabile {{baseUrl}}, in modo che passare da staging a produzione sia un singolo cambio di ambiente invece di modificare ogni richiesta. « Aggiungi intestazioni di autenticazione dallo schema di sicurezza » legge le definizioni bearer, chiave API u OAuth2 della specifica e aggiunge l'intestazione Authorization o key corrispondente come segnaposto. « Genera corpi di richiesta di esempio dagli schemi » crea un esempio JSON per ogni richiesta dal suo schema, seguendo i riferimenti $ref all'interno del documento, in modo che le richieste POST e PUT arrivino pre-compilate invece di essere vuote. I parametri di query possono essere inclusi con le loro descrizioni, gli endpoint deprecati possono essere completamente saltati e uno script di test di base che verifica un codice di stato riuscito può essere aggiunto a ogni richiesta.
I parametri di percorso come {id} diventano automaticamente variabili di percorso Postman :id, e i terminatori di riga CRLF e LF in un documento incollato vengono trattati allo stesso modo. Le specifiche grandi con centinaia di operazioni si convertono in un'unica passata; se la collezione supererebbe il limite di output, lo comunica invece di congelare la scheda.
Tutto accade localmente nel tuo browser — il documento che incolli, inclusi tutti i dettagli interni dell'API che contiene, non viene mai caricato da nessuna parte. Quando la collezione è pronta, copiala, scaricala come file o inviala all'input di un altro strumento per continuare a lavorarci.