markdown - 如何在 Apiary.io/API Blueprint 中指定请求正文属性？

Question

我试图弄清楚如何描述/定义 POST/PUT 的请求正文属性/参数。这是我正在尝试做的一个示例，但我在文档中的任何地方都找不到它(我希望有一种方法可以查看任何公共(public) Apiary 文档的 Markdown ):http://docs.bynder.apiary.io/#reference/metaproperties/metaproperty-access/save-new-metaproperty

查看“请求”部分下的描述和属性定义？我怎么做？

Answer 1

以下是他们可能是如何做到的。请查看 https://github.com/apiaryio/api-blueprint 上的 API 蓝图规范了解更多。

+ Request (application/json)

    You can have any description here. This is based on markdown.

    + Even a list
    + `name` Name of the metaproperty, should be alphanumeric only. Uneditable.

    + Body

            {
              "name": "app"
            }