Stoplight Studio(api設(shè)計(jì)開(kāi)發(fā)軟件)v1.13.1免費(fèi)版

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

功能介紹

全面支持OpenAPI v2和v3

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

Studio喜歡Swagger + OpenAPI

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

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

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

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

JSON模式建模

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

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

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

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

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

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

技術(shù)文檔

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

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

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

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

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

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

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

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

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

Built-in Mocking

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

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

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

自帶版本庫(kù)

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