如何使用Flasgger在API文档中展示代码示例？

你当前的x-code-samples配置不生效，核心问题是格式不符合OpenAPI规范要求——x-code-samples需要是数组类型，而非单个对象。

正确的配置格式如下：

x-code-samples:
  - lang: JavaScript
    source: |
      fetch('/your-api-path', {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({ key: 'value' })
      })
      .then(res => res.json())
      .then(data => console.log(data))
      .catch(err => console.error(err));
  - lang: Python
    source: |
      import requests

      url = "http://localhost:5000/your-api-path"
      payload = {"key": "value"}
      headers = {"Content-Type": "application/json"}

      response = requests.post(url, json=payload, headers=headers)
      print(response.json())

注意事项：

• 每个代码示例前必须加-，表示是数组中的一个元素
• 多行代码用|来保留换行和缩进，确保代码渲染时格式正确
• Flasgger基于OpenAPI规范，只要遵循规范配置，Swagger UI会自动在文档中展示对应的代码示例区块

内容的提问来源于stack exchange，提问作者Jean Paul Sierra Boom