Stoplight Studio是Stoplight用于API設計、建模和技術編寫的下一代應用程序，Studio的主要目標是豐富而不是取代您現(xiàn)有的工作流程，當在本地運行時，它可以完全脫機工作，文件夾和文件都在您的計算機上，就像您最喜歡的IDE一樣，當在瀏覽器中運行時，網(wǎng)絡原生的Git支持可以讓你毫不費力地安全有效地使用你現(xiàn)有的倉庫。

功能介紹

全面支持OpenAPI v2和v3

Studio的所有功能都完全支持OpenAPI 2和3版本的規(guī)范格式。這意味著對OpenAPI規(guī)范的兩個版本都有完整的驗證、嘲諷和建模支持。

Studio喜歡Swagger + OpenAPI

圖形化的API設計

基于表單的設計意味著你不需要是一個OpenAPI專家就可以開始。Studio有一個 "寫"（代碼）模式，具有完整的OpenAPI自動完成功能，還有一個 "讀 "模式，用于可視化HTTP操作和模型。

OpenAPI的圖形設計

要了解更多關于如何在不編寫一行JSON或YAML的情況下快速設計和原型API的信息，請看這里。

JSON模式建模

Studio不只是針對API，你還可以創(chuàng)建和修改獨立的JSON Schema文件來存儲數(shù)據(jù)模型。我們有沒有提到，這也是由圖形界面提供的？不用再尋找匹配的括號或缺失的空格，也不用熟悉JSON Schema的進退。

鼓勵重用，避免重復。

當涉及到API建模時，避免重復勞動可能是成功和失敗的區(qū)別。如果你的所有端點都以略微不同的方式重新創(chuàng)建相同的模型，你怎么能執(zhí)行一致性呢？(提示，你不能)

Studio的圖形化JSON模式編輯器允許您快速找到要引用的模型。

Studio允許您在需要的時候快速、輕松地找到并重用您需要的對象。不再需要為不同的端點重新創(chuàng)建模型，不再需要因為添加了新的字段而更新幾十個不同的端點。

要了解更多關于如何利用引用來擴展您的API一致性的信息，請看這里。

技術文檔

混合API參考文檔和基于Markdown的指南、操作方法、入門信息等。您的所有文檔都可以放在同一個項目中。Studio包括一個內(nèi)置的markdown編輯器，圖像管理器，以及將文檔發(fā)布到Stoplight新的文檔平臺的能力。

創(chuàng)建漂亮且易于使用的API參考文檔

您甚至可以將文件存放在您自己的 Git 倉庫中，然后在您準備好展示您的最新和最偉大的作品時發(fā)布。

要了解更多關于在Studio中編寫技術文檔的信息，請看我們的入門指南。

樣式指南和驗證

使用本機Spectral集成來強制執(zhí)行正確性和最佳實踐，并在創(chuàng)建錯誤時向您發(fā)出警報。

Spectral會驗證和過濾您的API，以確保它們的正確性和功能性。

點擊錯誤或警告，您還會看到它們在文檔中的確切位置，從而可以輕松地在源頭修復錯誤。

要了解更多關于Spectral的信息，以及驗證如何改善您的API設計工作流程，請看這里。

Built-in Mocking

當在本地運行時，Studio將自動為項目中定義的每個API啟動本地Prism模擬服務器，并在您更改設計時保持該模擬服務器的更新。

模擬允許你在進入代碼之前快速測試你的API的外觀和感覺。

要了解更多關于Prism的信息，以及如何使用嘲諷來簡化你的API開發(fā)流程，請看這里。

自帶版本庫

由于Studio與你的本地文件系統(tǒng)一起工作，你可以打開你的API項目，并開始添加文檔和設計，以及它們所要描述的實際實現(xiàn)。一旦完成，就可以用你最喜歡的Git客戶端將其全部檢查到Git中。

更新日志

將Spectral升級到v5.5.0-beta8。

修復了標記代碼塊的不正確渲染。

修正從包含循環(huán)引用的OpenAPI文檔中發(fā)送HTTP請求時的崩潰。

使用方法

1 下載完成后不要在壓縮包內(nèi)運行軟件直接使用，先解壓;

2 軟件同時支持32位64位運行環(huán)境;

3 如果軟件無法正常打開，請右鍵使用管理員模式運行;