简介

JSON 超级模式是 JSON Schema 的扩展，允许定义超媒体驱动的 API。超级模式词汇表展示了如何通过启用对可对 JSON 数据执行的链接和操作的描述，用超媒体控件来注释 JSON 文档。因此，它有助于提供更具交互性和动态性的 JSON 数据表示。它还通过在 JSON 文档中描述操作和链接的特性，增强了 API 的可发现性。

JSON 超级模式与现有的 JSON HTTP API 无缝集成，并提供描述复杂资源关系、简化客户端验证以及促进更好的交互模式的功能。它使 API 更直观、自描述且高效，尤其是在 RESTful 架构中。

本质上

• JSON 超级模式在复杂的 API 中非常有用，在这种 API 中，客户端需要定义并明确理解资源和操作之间的关系，尤其是在没有先验 API 结构知识的情况下浏览资源时。
• 它有助于创建更具可发现性和自文档性的 API，使客户端更容易与之交互。

超级模式规范

• 超级模式：draft-handrews-json-schema-hyperschema-02
• 相对 JSON 指针：draft-bhutton-relative-json-pointer-00

模式

• JSON 超级模式元模式
• JSON 超级模式词汇表模式
• JSON 超级模式链接描述对象元模式
• JSON Schema 输出模式和示例

发行说明

• 从 draft-07 到 2019-09
• 从 draft-04 到 draft-07
• 从 draft-04 到 draft-06