API 管理再進化:SwaggerHub 與 Postman Collection 的無縫整合

軟體開發的創新永遠不會放緩,而促進順利、高效 API 管理的工具是無價的。SwaggerHub Explore 以其強大的 API Discovery (探索) 功能而聞名,在最新的版本中取得了重大躍進。透過新的命令列介面 (CLI) 指令將 Postman Collection 直接匯入 Explore 的這項功能,對開發人員和 API 測試人員來說是一個突破。這項增強不僅彌補了 Postman 和 SwaggerHub 之間的差距,而且還簡化了 API 測試和探索過程,並進一步讓 API 管理變得更簡單。

輕鬆匯入

這個過程簡單直觀,透過利用 Explore CLI 中新的「Import Postman Collection」選項,使用者現在可以直接將匯出的 Postman Collection 直接匯入到 Explore 中。這個功能支援 CLI 中其他使用者所熟悉常見的參數,僅需要指定 Postman Collection 匯出的檔案路徑。

流線型-1.png

Explore CLI: https://www.nuget.org/packages/Explore.Cli

如何使用 Explore CLI: https://youtu.be/pFfSr8B92Fo ?list=PLrA5ciulugn87I051aAo9cvX2lagLh769&t=290

無縫過渡

想像一下,Postman 中有一個名為「Payees API」的完整的 API Request Collection,但需要 Explore 的進階探索功能。在新版本中,轉換此 Collection 就像運行指令一樣簡單。匯入功能不僅在 Explore 中為匯入的 API 建立了一個新空間,而且還完整的匯入了各種 Request 以及與這些 Request 相關的 Parameter。這種無縫整合確保在 Postman 中完成的所有準備工作不會有任何遺漏,並且可以立即在 Explore 中使用。

擁抱設計和 API 文件

透過從 Postman 切換到 Explore,您不僅可以存取進階 API Exploration 功能,還可以簡化產生 API 文件以及在 SwaggerHub 中安全儲存定義的作業。這使您能夠輕鬆推動「API First」計劃,讓開發變得更快、更好。

流線型-2.png

廣泛的相容性

這次更新中一個令人印象深刻的方面是它的相容性。Explore 的新功能支援基於 HTTP 和 SOAP 的 Collection,可以滿足各種 API 協定的需求。無論您的 Collection 是針對 RESTful 服務還是 SOAP,您都可以預期一個順利的匯入過程。

讓您的工作面向未來

值得注意的是,目前版本支援 2.1 版本的 Postman Collection。嘗試從之前版本匯入 Collection 可能會導致錯誤,提示使用者確保其 Collection 在匯入之前已更新為最新格式。

開始您的 API 探索與管理

這次更新的不僅僅是一項功能;它是 API 開發和測試中兩個最強大的工具之間的橋樑。透過促進 Postman Collection 的匯入,Explore 不僅擴大了其實用性,也強化了它對增強使用者體驗的承諾。無論您是在進行 API 的 debug、設計,還是只是在探索新的可能,這項新功能都有望讓您的開發體驗更加順暢、更有效率。

 

文章來源: Elevating API Exploration: Import Postman Collections, SmartBear 2024