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

Question

我正在使用OpenAPI（Swagger）来定义Web服务。

在响应部分中，我显式定义了以下代码

responses:
  '200':
    description: Your order has been placed
    content: ...

但是，当我调用服务时，它返回“200 OK”，这是标准的http状态代码描述，而不是我明确定义的描述

根据这里https://swagger.io/docs/specification/describing-responses/，它说“如果使用显式代码定义响应范围，则显式代码定义优先于该代码的范围定义。”

我错过/误解了什么吗？

Answer 1

OpenAPI 定义中的描述字段是仅用于文档目的的元数据。

此描述与HTTP响应中的状态文本(又名< code>reason-phrase)值无关，例如“HTTP/1.1 200 OK”中的“OK”。大多数服务器/框架使用通用状态文本，例如“200正常”或“403禁止”。