Stoplight Studio是一款專門用于API設計的變成軟件,它可以幫助用戶們利用api技術進行產品設計,研發等方面的操作,此外它還可以進行脫機工作,讓你的資料可以在本地計算機上進行運行,減少信息泄露的風險,極大的提高了用戶的隱私保護。
軟件特色
1.全面支持OpenAPI v2和v3
Studio的所有功能都完全支持OpenAPI 2和3版本的規范格式。這意味著對OpenAPI規范的兩個版本都有完整的驗證、嘲諷和建模支持。
Studio喜歡Swagger + OpenAPI
2.圖形化的API設計
基于表單的設計意味著你不需要是一個OpenAPI專家就可以開始。Studio有一個 "寫"(代碼)模式,具有完整的OpenAPI自動完成功能,還有一個 "讀 "模式,用于可視化HTTP操作和模型。
3.OpenAPI的圖形設計
要了解更多關于如何在不編寫一行JSON或YAML的情況下快速設計和原型API的信息,請看這里。
4.JSON模式建模
Studio不只是針對API,你還可以創建和修改獨立的JSON Schema文件來存儲數據模型。我們有沒有提到,這也是由圖形界面提供的?不用再尋找匹配的括號或缺失的空格,也不用熟悉JSON Schema的進退。
5.鼓勵重用,避免重復。
當涉及到API建模時,避免重復勞動可能是成功和失敗的區別。如果你的所有端點都以略微不同的方式重新創建相同的模型,你怎么能執行一致性呢?(提示,你不能)
6.Studio的圖形化JSON模式編輯器允許您快速找到要引用的模型。
Studio允許您在需要的時候快速、輕松地找到并重用您需要的對象。不再需要為不同的端點重新創建模型,不再需要因為添加了新的字段而更新幾十個不同的端點。
要了解更多關于如何利用引用來擴展您的API一致性的信息,請看這里。
7.技術文檔
混合API參考文檔和基于Markdown的指南、操作方法、入門信息等。您的所有文檔都可以放在同一個項目中。Studio包括一個內置的markdown編輯器,圖像管理器,以及將文檔發布到Stoplight新的文檔平臺的能力。
8.創建漂亮且易于使用的API參考文檔
您甚至可以將文件存放在您自己的 Git 倉庫中,然后在您準備好展示您的最新和最偉大的作品時發布。
要了解更多關于在Studio中編寫技術文檔的信息,請看我們的入門指南。
9.樣式指南和驗證
使用本機Spectral集成來強制執行正確性和最佳實踐,并在創建錯誤時向您發出警報。
Spectral會驗證和過濾您的API,以確保它們的正確性和功能性。
點擊錯誤或警告,您還會看到它們在文檔中的確切位置,從而可以輕松地在源頭修復錯誤。
要了解更多關于Spectral的信息,以及驗證如何改善您的API設計工作流程,請看這里。
10.Built-in Mocking
當在本地運行時,Studio將自動為項目中定義的每個API啟動本地Prism模擬服務器,并在您更改設計時保持該模擬服務器的更新。
模擬允許你在進入代碼之前快速測試你的API的外觀和感覺。
要了解更多關于Prism的信息,以及如何使用嘲諷來簡化你的API開發流程,請看這里。
11.自帶版本庫
由于Studio和你的本地文件系統一起工作,你可以打開你的API項目,并開始添加文檔和設計,以及它們所要描述的實際實現。一旦完成,就可以用你最喜歡的Git客戶端將其全部檢查到Git中。
更新日志
1.將Spectral升級到v5.5.0-beta8。
2.修復了標記代碼塊的不正確渲染。
3.修正從包含循環引用的OpenAPI文檔中發送HTTP請求時的崩潰。
-
7 中望3D2021
裝機必備軟件
網友評論