Colecție OpenAPI pentru Postman
Transformați un document OpenAPI sau Swagger într-o colecție Postman v2.1 gata pentru import.
Colecție OpenAPI pentru Postman
Lipiți un document OpenAPI 3 sau Swagger 2 — JSON sau YAML — și acest instrument construiește o colecție Postman v2.1 pe care o puteți importa direct în Postman, Insomnia sau orice client care citește formatul. Fiecare operație din specificație devine o cerere, organizată în dosare, astfel încât un API mare rămâne navigabil în loc să fie descărcat ca o singură listă plată.
Grupați cererile după etichetă sau după primul segment de cale, în funcție de cum echipa dvs. deja gândește la API. Activați "Inserare URL-ul de bază ca variabilă de mediu" pentru a înlocui URL-ul serverului cu o variabilă {{baseUrl}}, permițând schimbarea între producție și test ca o singură modificare de mediu în loc de editarea fiecărei cereri. "Adaugare anteturi de autentificare din schema de securitate" citește definițiile bearer, cheie API sau OAuth2 din specificație și adaugă antetul Authorization sau cheia corespunzător ca marcaj. "Generare corpuri de cerere de exemplu din scheme" construiește un exemplu JSON pentru fiecare cerere pe baza schemei sale, urmărind referințele $ref din document, permițând cererilor POST și PUT să sosească pre-completate în loc de goale. Parametrii de interogare pot fi incluși cu descrierile lor, punctele finale depreciate pot fi complet omise, iar un script de test de bază care verifică un cod de stare reușit poate fi adăugat la fiecare cerere.
Parametrii de cale cum ar fi {id} devin automat variabile de cale :id din Postman, iar terminațiile de linie CRLF și LF dintr-un document lipit sunt tratate la fel. Specificațiile mari cu sute de operații se convertesc într-o singură trecere; dacă colecția ar depăși limita de ieșire, aceasta vă avertizează în loc să înghețe fila.
Tot ceea ce se întâmplă local în browser — documentul pe care îl lipiți, inclusiv orice detalii interne ale API pe care le conține, nu sunt niciodată încărcate nicăieri. Când colecția este gata, copiați-o, descărcați-o ca fișier sau trimiteți-o la intrarea altui instrument pentru a continua lucrul.