OpenAPI Postman-gyűjteménnyé
OpenAPI vagy Swagger dokumentumot konvertáljon könnyen importálható Postman v2.1 gyűjteménnyé.
OpenAPI Postman-gyűjteménnyé
Illesszen be egy OpenAPI 3 vagy Swagger 2 dokumentumot — JSON vagy YAML formátumban — és ez az eszköz egy Postman v2.1 gyűjteményt hoz létre, amelyet közvetlenül importálhat a Postmanba, az Insomniaba vagy bármely más, ezt a formátumot támogató kliensbe. A specifikáció minden művelete egy kéréssé válik, mappákba szervezve, hogy egy nagyobb API navigálható maradjon, ne pedig egyetlen nagy listáként landoljon.
Csoportosítsa a kéréseket cimkék alapján vagy az első útvonal-szegmens alapján, attól függően, hogy a csapata hogyan gondol az API-ra. Kapcsolja be az "Alap URL beszúrása környezeti változóként" opciót, hogy az szerver URL-jét egy {{baseUrl}} változóra cserélje, így a staging és a production közötti váltás csupán egy környezeti változás lesz, nem pedig minden kérés szerkesztése. Az "Auth fejlécek hozzáadása a biztonsági sémából" opcióval az eszköz beolvassa a spec hordozó, API-kulcs vagy OAuth2 definícióit, és hozzáadja a megfelelő Authorization vagy kulcs fejlécet helyőrzőként. A "Mintakérési szervek létrehozása sémákból" opcióval a JSON-példák automatikusan generálódnak az egyes kérésekhez a sémájukból, a dokumentumon belüli $ref hivatkozásokat követve, így a POST és PUT kérések előre kitöltve érkeznek, nem pedig üresek. A lekérdezési paraméterek leírásokkal is beilleszthetők, az elavultként megjelölt végpontok teljesen kihagyhatók, és egy alapvető állapotkód-tesztet ellenőrző script hozzáadható az egyes kérésekhez.
Az útvonalparaméterek, mint például az {id}, automatikusan Postman :id útvonalváltozóivá válnak, és a beillesztett dokumentumban lévő CRLF és LF sorvégek azonosnak kezelendők. A százakfős operációkkal rendelkező nagyobb specifikációk egy lépésben konvertálódnak; ha a gyűjtemény túllépné a kimeneti korlátot, az helyett, hogy befagyasztana a lapot, ezt a program közli.
Minden folyamat helyileg, a böngészőben történik — a beillesztett dokumentum, beleértve az abban szereplő belső API-részleteket, sehova nem kerül feltöltésre. Ha a gyűjtemény kész, másolja ki, töltse le fájlként, vagy küldje el egy másik eszköz bemenetéhez, hogy folytathasson dolgozni rajta.