我正在使用OpenAPI(Swagger(来定义web服务。
在响应部分,我明确定义了以下代码
responses:
'200':
description: Your order has been placed
content: ...
然而,当我呼叫该服务时,它返回";200 OK";,这是一个标准的http状态代码描述,而不是我明确定义的描述
根据这里https://swagger.io/docs/specification/describing-responses/,上面写着";如果使用显式代码定义响应范围,则显式代码的定义优先于该代码的范围定义">
我错过/误解了什么吗?
OpenAPI定义中的description
字段是仅用于文档目的的元数据。
该描述与HTTP响应中的状态文本(又名reason-phrase
(值无关;OK";在";HTTP/1.1 200 OK";。大多数服务器/框架使用公共状态文本;200 OK";或";403禁止";。