apiblueprint - 不同版本的 API 蓝图

Question

http://apiblueprint.org/#get-started上示例的结构似乎与 APIary.io 上的结构不同。

任何人都可以评论它们是否不同，如果是，哪种结构是正确的？

例如，

API 蓝图文档结构

1.) 元数据 2.) API 名称和概述 3.) 资源 A.) URI 参数 B.) 模型 1.) 标头 2.) 正文 3.) 模式 C.) 操作 1.) URI 参数 2.) 请求.) 标题 b.) 正文 c.) 架构 3.) 响应 a.) 标题 b.) 正文 c.) 架构 4.) 资源组 A.) 资源

相对

{
    "_version": "2.0",
    "metadata": [],
    "name": "",
    "description": "",
    "resourceGroups": [
        {
            "name": "",
            "description": "",
            "resources": [
                {
                    "name": "",
                    "description": "",
                    "uriTemplate": "/message",
                    "model": {},
                    "parameters": [],
                    "actions": [
                        {
                            "name": "",
                            "description": "",
                            "method": "GET",
                            "parameters": [],
                            "examples": [
                                {
                                    "name": "",
                                    "description": "",
                                    "requests": [],
                                    "responses": [
                                        {
                                            "name": "200",
                                            "description": "",
                                            "headers": [
                                                {
                                                    "name": "Content-Type",
                                                    "value": "text/plain"
                                                }
                                            ],
                                            "body": "Hello World!\n",
                                            "schema": ""
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

非常感谢，

Answer 1

您提到的“API 蓝图文档结构”是您编写 API 蓝图文档的方式。

您在上面编写的 JSON 是您在使用 API 蓝图解析器（如https://github.com/apiaryio/snowcrash ）解析上述 API 蓝图时获得的 AST 。

因此，它们都正确地代表了您的 API 蓝图，但非 AST 的蓝图更具可读性。

希望能消除您的困惑。