本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 步骤 1：生成 API 客户端
<a name="client-sdk"></a>

Session Manager API 是在单个 YAML 文件中定义的。这些 API 基于 OpenAPI3.0 规范，该规范定义了与语言无关的标准 RESTful API 接口。有关更多信息，请参阅 [OpenAPI 规范](https://swagger.io/specification/)。

通过使用 YAML 文件，您可以使用支持的语言之一生成 API 客户端。为此，您必须使用 Swagger Codegen 3.0 或更高版本。有关支持的语言的更多信息，请参阅 [swagger-codegen 存储库](https://github.com/swagger-api/swagger-codegen#overview)。

**生成 API 客户端**

1. 从 Session Manager Broker 中下载 Session Manager API YAML 文件。在以下 URL 中提供了该 YAML 文件。

   ```
   https://{{broker_host_ip}}:{{port}}/dcv-session-manager-api.yaml
   ```

1. 安装 Swagger Codegen。
   + macOS

     ```
     $ brew install swagger-codegen
     ```
   + 其他平台

     ```
     $ git clone https://github.com/swagger-api/swagger-codegen --branch 3.0.0
     ```

     ```
     $ cd swagger-codegen
     ```

1. 生成 API 客户端。
   + macOS

     ```
     $ swagger-codegen generate -i {{/path_to/yaml_file}} -l {{language}} -o ${{output_folder}}
     ```
   + 其他平台

     ```
     $ mvn clean package
     ```

     ```
     $ java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate -i {{/path_to/yaml_file}} -l {{language}} -o {{output_folder}}
     ```