Stoplight Studio 是Stoplight 的下一代应用程序，用于API 设计、建模和技术编写。 Studio 的主要目标是丰富而不是取代您现有的工作流程。在本地运行时，它可以完全离线工作。文件就在您的计算机上，就像您最喜欢的IDE 一样。

Stoplight Studio 是Stoplight 的下一代应用程序，用于API 设计、建模和技术编写。 Studio 的主要目标是丰富而不是取代您现有的工作流程。在本地运行时，它可以完全离线工作。文件文件夹和文件都在您的计算机上，就像您最喜欢的IDE 一样，并且在浏览器中运行时，Web 原生Git 支持可以轻松安全、高效地使用现有存储库。

特征

完全支持OpenAPI v2 和v3

Studio 的所有功能完全支持OpenAPI 版本2 和3 规范格式。这意味着两个版本的OpenAPI 规范都有完整的验证、模拟和建模支持。

Studio 喜欢Swagger + OpenAPI

图形化API设计

基于表单的设计意味着您无需成为OpenAPI 专家即可开始使用。 Studio 具有具有完整OpenAPI 自动完成功能的“写入”（代码）模式，以及用于可视化HTTP 操作和模型的“读取”模式。

OpenAPI 的图形设计

要详细了解如何快速设计API 并对其进行原型设计，而无需编写一行JSON 或YAML，请查看此处。

JSON 模式建模

Studio不仅仅用于API，您还可以创建和修改独立的JSON Schema文件来存储数据模型。我们是否提到这也是由图形界面提供的？不再需要寻找匹配的括号或缺失的空格，也不再需要熟悉JSON 模式的来龙去脉。

鼓励重复使用并避免重复。

在API 建模方面，避免重复工作可能是成功与失败的区别。如果所有端点以略有不同的方式重新创建相同的模型，如何强制一致性？ （提示，你不能）

Studio 的图形JSON 架构编辑器可让您快速找到要引用的模型。

Studio 允许您在需要时快速轻松地查找和重复使用所需的对象。不再需要为不同的端点重新创建模型，也不再需要在添加新字段时更新数十个不同的端点。

要了解有关如何利用参考来扩展API 一致性的更多信息，请参阅此处。

技术文档

混合API 参考文档和基于Markdown 的指南、操作方法、入门信息等。您的所有文档都可以放在同一个项目中。 Studio 包括内置的Markdown 编辑器、图像管理器以及将文档发布到Stoplight 的新文档平台的功能。

创建美观且易于使用的API 参考文档

您甚至可以将文件存储在您自己的Git 存储库中，然后在准备好展示您最新和最伟大的创作时发布它们。

要了解有关在Studio 中编写技术文档的更多信息，请查看我们的入门指南。

风格指南和验证

使用本机Spectral 集成来强制执行正确性和最佳实践，并在出现错误时向您发出警报。

Spectral 会验证和过滤您的API，以确保它们正确且有效。

单击错误或警告，您还将看到它们在文档中的确切位置，从而可以轻松地从源头修复错误。

要了解有关Spectral 以及验证如何改进API 设计工作流程的更多信息，请查看此处。

内置模拟

在本地运行时，Studio 将自动为项目中定义的每个API 启动本地Prism 模拟服务器，并在您对设计进行更改时保持该模拟服务器更新。

模拟允许您在进入代码之前快速测试API 的外观和感觉。

要了解有关Prism 以及如何使用模拟来简化API 开发流程的更多信息，请查看此处。

自带版本库

由于Studio 使用本地文件系统，因此您可以打开API 项目并开始添加文档和设计，以及它们要描述的实际实现。完成后，您可以使用您最喜欢的Git 客户端将其全部签入Git。

变更日志

将Spectral 升级至v5.5.0-beta8。

修复了标记代码块的错误渲染。

修复了从包含循环引用的OpenAPI 文档发送HTTP 请求时发生的崩溃。