Stoplight Studio是一款專門用于API設(shè)計(jì)的變成軟件，它可以幫助用戶們利用api技術(shù)進(jìn)行產(chǎn)品設(shè)計(jì)，研發(fā)等方面的操作，此外它還可以進(jìn)行脫機(jī)工作，讓你的資料可以在本地計(jì)算機(jī)上進(jìn)行運(yùn)行，減少信息泄露的風(fēng)險(xiǎn)，極大的提高了用戶的隱私保護(hù)。

軟件特色

1.全面支持OpenAPI v2和v3

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

Studio喜歡Swagger + OpenAPI

2.圖形化的API設(shè)計(jì)

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

3.OpenAPI的圖形設(shè)計(jì)

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

4.JSON模式建模

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

5.鼓勵(lì)重用，避免重復(fù)。

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

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

Studio允許您在需要的時(shí)候快速、輕松地找到并重用您需要的對象。不再需要為不同的端點(diǎn)重新創(chuàng)建模型，不再需要因?yàn)樘砑恿诵碌淖侄味聨资畟€(gè)不同的端點(diǎn)。

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

7.技術(shù)文檔

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

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

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

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

9.樣式指南和驗(yàn)證

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

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

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

要了解更多關(guān)于Spectral的信息，以及驗(yàn)證如何改善您的API設(shè)計(jì)工作流程，請看這里。

10.Built-in Mocking

當(dāng)在本地運(yùn)行時(shí)，Studio將自動為項(xiàng)目中定義的每個(gè)API啟動本地Prism模擬服務(wù)器，并在您更改設(shè)計(jì)時(shí)保持該模擬服務(wù)器的更新。

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

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

11.自帶版本庫

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

更新日志

1.將Spectral升級到v5.5.0-beta8。

2.修復(fù)了標(biāo)記代碼塊的不正確渲染。

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