我应该如何为其 API 使用 MailChimp JSON 架构?

How am I supposed to consume the MailChimp JSON Schema for its API?

在其网站的开发者部分,MailChimp 链接到描述其 API 的 JSON 模式。

http://developer.mailchimp.com/documentation/mailchimp/guides/get-started-with-mailchimp-api-3/#json-schema

我熟悉 JSON 模式(草案 v4)。我了解它们在 API 有效载荷验证、文档生成等方面的作用。我也熟悉它们如何与 Swagger (OpenAPI) 模式(在某些方面相似但更全面地记录 API).

MailChimp 的架构似乎是一种类似 Swagger 的 API 描述,但基于 JSON 架构语法。起初,它看起来像一个 JSON Hyper-Schema,但它有 'schema' 和 'targetSchema' 字段引用其他 JSON 文件而不使用 JSON 指针(https://spacetelescope.github.io/understanding-json-schema/structuring.html).它还混合了一些 HATEOAS 概念?

什么工具可以让我在不手动协调 MailChimp 发布的所有 JSON 模式文件的情况下使用这个 JSON 模式?

我的最终目标是创建 MailChimp API 的 Swagger 2.0 (OpenAPI) 定义。我有一个工具可以从 JSON Hyper-Schemas 转换为 Swagger 2.0。

我的理解是 MailChimp 正在从 JSON Hyperschema 过渡到 Swagger,因为这就是他们生成文档的方式。您可能想联系他们的 API 服务台,看看是否可以公开使用 swagger。

我采纳了 TooMuchPete 的建议。

这是 MailChimp 所说的:

Hi Jordan,

Thanks for reaching out. At the current time, we use a mix of both of these specifications. We currently use Swagger to lay out our schema for documentation purposes, however, we use the JSON schemas for other functions such as request validation and other parts of the API. That said, we are currently in the process of transitioning these functions over to Swagger. With that said, below is a URL that should be helpful in consuming our schemas.

http://api.mailchimp.com/schema/3.0/Swagger.json