添加 SDK 示例

在 API 端点旁展示特定语言的代码示例，向开发者说明如何使用你的 SDK

如果你的用户通过 SDK 与 API 交互，而非直接发起网络请求，你可以使用 x-codeSamples 扩展将代码示例添加到 OpenAPI 文档中，并在 OpenAPI 页面中展示它们。

该属性可添加到任何请求方法中，且具有以下模式。

lang · string · required

代码示例所用的语言。

label · string

示例的标签。在为单个端点提供多个示例时非常有用。

source · string · required

示例的源代码。

下面是一个植物追踪应用的代码示例，其中同时包含 Bash 命令行界面（CLI）工具和 JavaScript SDK。

paths:
  /plants:
    get:
      # ...
      x-codeSamples:
        - lang: bash
          label: 列出所有未浇水的植物
          source: |
            planter list -u
        - lang: javascript
          label: 列出所有未浇水的植物
          source: |
            const planter = require('planter');
            planter.list({ unwatered: true });
        - lang: bash
          label: 列出所有盆栽植物
          source: |
            planter list -p
        - lang: javascript
          label: 列出所有盆栽植物
          source: |
            const planter = require('planter');
            planter.list({ potted: true });