不带requestbody的Swagger OpenAPI post应用程序/json
我的API只使用不带requestbody的Swagger OpenAPI post应用程序/json,swagger,openapi,swagger-php,Swagger,Openapi,Swagger Php,我的API只使用头-内容类型:application/json对象的请求 为了做到这一点,我使用: @OA\RequestBody( description= "Provide company search parameter", required= true, @OA\JsonContent( type="object", @OA\Property(property="company_name", type="string")
头-内容类型:application/json
对象的请求
为了做到这一点,我使用:
@OA\RequestBody(
description= "Provide company search parameter",
required= true,
@OA\JsonContent(
type="object",
@OA\Property(property="company_name", type="string")
)
)
但是对于某些请求,我不需要RequestBody
,只需点击资源并获取数据。如果没有RequestBody
,我怎么做
注意:此请求需要GET
方法(POST
,如果有帮助的话),但GET
不接受RequestBody
OAS 3.0无法描述这种情况,对GET RequestBody的限制是为了避免试图描述HTTP规范中未定义的API行为。将内容类型指定为“手动”定义的标题的限制也是为了确保应该设置此标题的机制不存在歧义
当客户端发送内容类型
头时,它用于描述请求的主体(而不是响应)
要影响响应类型,客户端可以发送。例如:
Accept:application/json
OAS 3.0无法描述这种情况,对GET RequestBody的限制是为了避免试图描述HTTP规范中未定义的API行为。将内容类型指定为“手动”定义的标题的限制也是为了确保应该设置此标题的机制不存在歧义
当客户端发送内容类型
头时,它用于描述请求的主体(而不是响应)
要影响响应类型,客户端可以发送。例如:
Accept:application/json
谢谢。我刚把我所有的API都改成post。谢谢。我只是把我所有的API都改成post。