1

我的 API 只使用Header - Content-type:application/json对象的请求。

为此，我使用：

 @OA\RequestBody(
    description= "Provide company search parameter",
    required= true,
    @OA\JsonContent(
        type="object",
        @OA\Property(property="company_name", type="string")
    )
 )

但是对于一些我不需要的请求RequestBody，只需点击资源并获取数据。没有我怎么办RequestBody？

PS 这个请求需要一个GET方法（POST如果有帮助，可以使用），但GET不接受RequestBody.

4

1 回答 1

0

OAS 3.0 无法描述这种情况，对 GET requestBodies 的限制是为了避免尝试描述 HTTP 规范中未定义的 API 行为。将 Content-Type 指定为“手动”定义的标头的限制也是为了确保对于应该设置此标头的机制没有歧义。

https://github.com/OAI/OpenAPI-Specification/issues/1628

当客户端发送Content-Type标头时，它用于描述请求的主体（而不是响应）

为了影响响应类型，客户端可以发送Accept 标头。
例如：Accept: application/json

于 2019-02-28T23:03:08.253 回答