本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 步驟 1：產生您的 API 用戶端


Session Manager APIs 是在單一 YAML 檔案中定義。APIs 是以 OpenAPI3.0 規格為基礎，定義 RESTful APIs 的標準、語言無關界面。如需詳細資訊，請參閱 [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 檔案。YAML 檔案可在下列 URL 取得。

   ```
   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
     ```