调用服务但返回代码的描述与我明确定义的不匹配



我正在使用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禁止";。

相关内容

最新更新