如何在Swagger (OpenApi)中添加JSON请求和响应示例？

在Swagger（OpenAPI）中添加JSON请求和响应示例的方法如下：

1. 首先，在Swagger（OpenAPI）的规范文件中，找到对应的API接口定义。
2. 在该API接口定义的parameters中，添加一个新的字段example来指定请求示例的JSON数据。例如：

parameters:
  - name: body
    in: body
    required: true
    schema:
      type: object
      properties:
        name:
          type: string
      example:
        name: "John Doe"

在上面的示例中，我们通过example字段给出了一个请求示例，其中name字段的值为"John Doe"。

1. 接下来，在API接口定义的responses中，为每个HTTP响应码添加一个新的字段examples，用于指定该响应码对应的响应示例的JSON数据。例如：

responses:
  '200':
    description: OK
    examples:
      application/json:
        id: 1
        name: "John Doe"

在上面的示例中，我们通过examples字段给出了一个成功响应码200对应的响应示例，其中包含了id和name字段的值。

1. 最后，使用Swagger（OpenAPI）工具生成API文档时，会自动根据上述添加的示例数据来展示请求和响应的JSON示例。

通过上述步骤，我们可以在Swagger（OpenAPI）中添加JSON请求和响应示例，方便开发者理解和使用API接口。关于Swagger（OpenAPI）的更多信息和腾讯云相关产品和服务，你可以参考腾讯云的文档：腾讯云API网关-文档中心。