apiblueprint - 是否可以使用蓝图指定进入帖子正文的参数？

Question

我希望能够将参数记录为 URL 参数，因为我喜欢这些文档如何呈现一个方便的表格。但是，在我的 API 中，我希望将这些参数插入 JSON 正文而不是 URL。有没有办法做到这一点？

Answer 1

用于描述、讨论（并因此也验证）消息体的专用语法正在制定中。

它将基于Object Notation 的 Markdown 语法，类似于实际的 URI 参数描述语法（最终这两者应该会聚）。

另请参阅相关的如何为 json 请求对象指定可选元素和是否可以记录 JSON 响应字段是什么？问题。