jsonschema - 如何使用 MSON 定义 ApiBlueprint 数组值示例？

Question

我可以使用 MSON 来指定示例值而不是+ Body吗？是否可以覆盖预定义的结构值？

我试过这样：

+ Request (application/json)

    + Headers

            Authorization: JWT <token>    
    + Attributes (ClientsideCommand)
        + alias: `show-xc`
        + args (array[AppCommandArg], fixed-type)
            + (AppCommandArg)
                + arg_key: address
                + order: 1
                + required: true
                + skip_arg_name: true
            + (AppCommandArg)
                + arg_key: `-A1`
                + order: 2
                + required: true
                + skip_arg_name: false

但是这样的定义破坏了 json-schema，因为 AppCommandArg 被描述为单独的对象。而且在从 MSON 生成的 JSON 中有 3 个项目，其中第一项是 deafult AppCommandArg。

Answer 1

看起来不可能把这件事放在一起。如果您按照上面所示添加元素，Apiary 会按照它看到的方式呈现它，如果一个元素被两次记录，那么 json 模式也将对其进行两次描述。