java - JSON 架构与开放 API - Java 支持

Question

我在这里遇到了这个 JSON 模式规范。

http://json-schema.org/understanding-json-schema/

我想知道它是否以某种方式与 Open API 规范相关。

https://swagger.io/specification/

1. 两种规范在多大程度上都是标准规范？我知道 Open API 被广泛使用，但它真的被大公司采纳为事实上的标准吗？

2. 哪个对 Java 的支持更好，“更”标准？
   我的意思是例如从哪种类型的 API 定义，您可以更轻松地生成客户端类以在您的客户端代码中使用？

3. 假设您有一个需要使用的 API(例如通过 Java 客户端)。您会向您的 API 提供商提出什么要求，您会要求 JSON 架构 API 定义，还是基于开放 API 的 API 定义？

Answer 1

第一个链接是一个文档站点，讨论 JSON Schema，其 official site is here谁的specification is here . JSON Schemas 用于描述和验证各种数据结构(只要它们可以用 JSON 文档模型表示)，但它在 HTTP 应用程序中具有广泛的用途。

Swagger 现在被称为 OpenAPI(移动到版本 3.x)。它的official site is here和 latest specification is here .它在内部使用 JSON 模式作为其数据结构的一部分。它专门针对 HTTP 请求和响应的描述(有时是验证)。

这两个站点都有各种平台和语言的实现索引。