apiblueprint - 如何在 API 蓝图中为每个端点指定多个请求类型？

Question

是否可以定义发生PUT to /asdf空请求正文时发生的情况与发生PUT to /asdf此请求正文时发生的情况{ "value": "somthing" }。

Answer 1

假设两个请求的媒体类型相同并且响应 HTTP 状态代码不同，这应该是合法的：

# PUT /asdf
+ Request Empty (application/json)
    + Headers

            Content-Lenght: 0

+ Response 400

+ Request With Value (application/json)

        { "value": "somthing" }

+ Response 204