tencentcloud-sdk-nodejs 4.1.304 → 4.1.305

package/es/common/sdk_version.js

@@ -1 +1 @@
-export const sdkVersion = "4.1.304";
+export const sdkVersion = "4.1.305";

package/es/services/apm/v20210622/apm_client.js

@@ -15,6 +15,9 @@ export class Client extends AbstractClient {
     async ModifyApmService(req, cb) {
         return this.request("ModifyApmService", req, cb);
     }
+    async DescribeRelatedServicesOnTrace(req, cb) {
+        return this.request("DescribeRelatedServicesOnTrace", req, cb);
+    }
     async DescribeGeneralOTSpanList(req, cb) {
         return this.request("DescribeGeneralOTSpanList", req, cb);
     }

package/es/services/trtc/v20190722/trtc_client.js

@@ -6,9 +6,15 @@ export class Client extends AbstractClient {
     async CreateCloudModeration(req, cb) {
         return this.request("CreateCloudModeration", req, cb);
     }
+    async DescribeTRTCRealTimeQualityData(req, cb) {
+        return this.request("DescribeTRTCRealTimeQualityData", req, cb);
+    }
     async StopWebRecord(req, cb) {
         return this.request("StopWebRecord", req, cb);
     }
+    async UpdateVoicePrint(req, cb) {
+        return this.request("UpdateVoicePrint", req, cb);
+    }
     async UpdateAIConversation(req, cb) {
         return this.request("UpdateAIConversation", req, cb);
     }
@@ -24,8 +30,8 @@ export class Client extends AbstractClient {
     async DescribeWebRecord(req, cb) {
         return this.request("DescribeWebRecord", req, cb);
     }
-    async StartPublishCdnStream(req, cb) {
-        return this.request("StartPublishCdnStream", req, cb);
+    async DownloadRecognizeVocabV3(req, cb) {
+        return this.request("DownloadRecognizeVocabV3", req, cb);
     }
     async DescribeCallDetailInfo(req, cb) {
         return this.request("DescribeCallDetailInfo", req, cb);
@@ -42,11 +48,17 @@ export class Client extends AbstractClient {
     async StopMCUMixTranscodeByStrRoomId(req, cb) {
         return this.request("StopMCUMixTranscodeByStrRoomId", req, cb);
     }
+    async UpdateRecognizeVocabV3(req, cb) {
+        return this.request("UpdateRecognizeVocabV3", req, cb);
+    }
+    async SetVocabStateV3(req, cb) {
+        return this.request("SetVocabStateV3", req, cb);
+    }
     async DescribeTRTCRealTimeScaleData(req, cb) {
         return this.request("DescribeTRTCRealTimeScaleData", req, cb);
     }
-    async DeleteVoicePrint(req, cb) {
-        return this.request("DeleteVoicePrint", req, cb);
+    async DescribeAIConversation(req, cb) {
+        return this.request("DescribeAIConversation", req, cb);
     }
     async StartMCUMixTranscodeByStrRoomId(req, cb) {
         return this.request("StartMCUMixTranscodeByStrRoomId", req, cb);
@@ -63,6 +75,9 @@ export class Client extends AbstractClient {
     async RemoveUserByStrRoomId(req, cb) {
         return this.request("RemoveUserByStrRoomId", req, cb);
     }
+    async DeleteRecognizeVocabV3(req, cb) {
+        return this.request("DeleteRecognizeVocabV3", req, cb);
+    }
     async DeletePicture(req, cb) {
         return this.request("DeletePicture", req, cb);
     }
@@ -75,14 +90,14 @@ export class Client extends AbstractClient {
     async DescribeTRTCSegmentModerationUsage(req, cb) {
         return this.request("DescribeTRTCSegmentModerationUsage", req, cb);
     }
-    async UpdateVoicePrint(req, cb) {
-        return this.request("UpdateVoicePrint", req, cb);
+    async CreateRecognizeVocabV3(req, cb) {
+        return this.request("CreateRecognizeVocabV3", req, cb);
     }
     async RemoveUser(req, cb) {
         return this.request("RemoveUser", req, cb);
     }
-    async StopMCUMixTranscode(req, cb) {
-        return this.request("StopMCUMixTranscode", req, cb);
+    async StartPublishCdnStream(req, cb) {
+        return this.request("StartPublishCdnStream", req, cb);
     }
     async DescribeLiveStreamModeration(req, cb) {
         return this.request("DescribeLiveStreamModeration", req, cb);
@@ -195,8 +210,8 @@ export class Client extends AbstractClient {
     async UpdatePublishCdnStream(req, cb) {
         return this.request("UpdatePublishCdnStream", req, cb);
     }
-    async DescribeTRTCRealTimeQualityData(req, cb) {
-        return this.request("DescribeTRTCRealTimeQualityData", req, cb);
+    async DeleteVoicePrint(req, cb) {
+        return this.request("DeleteVoicePrint", req, cb);
     }
     async CreateCloudSliceTask(req, cb) {
         return this.request("CreateCloudSliceTask", req, cb);
@@ -213,8 +228,8 @@ export class Client extends AbstractClient {
     async DescribeCloudModeration(req, cb) {
         return this.request("DescribeCloudModeration", req, cb);
     }
-    async DescribeAIConversation(req, cb) {
-        return this.request("DescribeAIConversation", req, cb);
+    async GetRecognizeVocabListV3(req, cb) {
+        return this.request("GetRecognizeVocabListV3", req, cb);
     }
     async DescribeTRTCMarketQualityData(req, cb) {
         return this.request("DescribeTRTCMarketQualityData", req, cb);
@@ -237,4 +252,10 @@ export class Client extends AbstractClient {
     async TextToSpeechSSE(req, cb) {
         return this.request("TextToSpeechSSE", req, cb);
     }
+    async StopMCUMixTranscode(req, cb) {
+        return this.request("StopMCUMixTranscode", req, cb);
+    }
+    async GetRecognizeVocabV3(req, cb) {
+        return this.request("GetRecognizeVocabV3", req, cb);
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs",
-  "version": "4.1.304",
+  "version": "4.1.305",
   "description": "腾讯云 API NODEJS SDK",
   "main": "./tencentcloud/index.js",
   "module": "./es/index.js",

package/tencentcloud/common/sdk_version.d.ts

@@ -1 +1 @@
-export declare const sdkVersion = "4.1.304";
+export declare const sdkVersion = "4.1.305";

package/tencentcloud/common/sdk_version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkVersion = void 0;
-exports.sdkVersion = "4.1.304";
+exports.sdkVersion = "4.1.305";

package/tencentcloud/services/apm/v20210622/apm_client.d.ts

@@ -1,6 +1,6 @@
 import { AbstractClient } from "../../../common/abstract_client";
 import { ClientConfig } from "../../../common/interface";
-import { DescribeApmAssociationResponse, CreateApmInstanceRequest, DescribeApmVulnerabilityCountResponse, DescribeServiceOverviewResponse, DescribeApmSQLInjectionDetailResponse, DescribeApmSampleConfigRequest, DescribeApmAllVulCountResponse, DescribeApmSampleConfigResponse, DescribeServiceOverviewRequest, DescribeTopologyNewResponse, DescribeOPRAllVulCountResponse, ModifyApmApplicationConfigResponse, DescribeApmServiceMetricResponse, ModifyApmAssociationRequest, DescribeGeneralOTSpanListResponse, DescribeApmApplicationConfigResponse, DescribeApmAssociationRequest, CreateProfileTaskRequest, DescribeApmVulnerabilityDetailRequest, DeleteApmSampleConfigResponse, DescribeApmPrometheusRuleRequest, CreateApmPrometheusRuleResponse, TerminateApmInstanceResponse, DescribeApmAgentResponse, CreateApmSampleConfigRequest, DescribeTagValuesRequest, CreateApmSampleConfigResponse, ModifyApmAssociationResponse, DescribeGeneralSpanListRequest, DescribeApmAgentRequest, DescribeMetricRecordsRequest, DescribeGeneralMetricDataRequest, ModifyApmPrometheusRuleRequest, ModifyApmInstanceResponse, DescribeGeneralMetricDataResponse, ModifyApmInstanceRequest, DescribeApmInstancesResponse, DescribeApmPrometheusRuleResponse, ModifyApmSampleConfigResponse, DescribeApmApplicationConfigRequest, CreateProfileTaskResponse, DescribeApmVulnerabilityDetailResponse, ModifyApmPrometheusRuleResponse, DescribeMetricRecordsResponse, DescribeApmSQLInjectionDetailRequest, DescribeGeneralOTSpanListRequest, DescribeGeneralApmApplicationConfigResponse, CreateApmInstanceResponse, DescribeGeneralApmApplicationConfigRequest, DescribeTopologyNewRequest, DescribeApmInstancesRequest, DeleteApmSampleConfigRequest, DescribeApmVulnerabilityCountRequest, ModifyApmSampleConfigRequest, TerminateApmInstanceRequest, ModifyGeneralApmApplicationConfigRequest, DescribeApmServiceMetricRequest, CreateApmPrometheusRuleRequest, DescribeApmAllVulCountRequest, DescribeTagValuesResponse, DescribeGeneralSpanListResponse, ModifyApmServiceResponse, ModifyApmApplicationConfigRequest, ModifyGeneralApmApplicationConfigResponse, ModifyApmServiceRequest, DescribeOPRAllVulCountRequest } from "./apm_models";
+import { DescribeApmAssociationResponse, CreateApmInstanceRequest, DescribeApmVulnerabilityCountResponse, DescribeServiceOverviewResponse, DescribeApmSQLInjectionDetailResponse, DescribeRelatedServicesOnTraceResponse, DescribeApmAllVulCountResponse, DescribeApmSampleConfigResponse, DescribeServiceOverviewRequest, DescribeTopologyNewResponse, DescribeOPRAllVulCountResponse, ModifyApmApplicationConfigResponse, DescribeApmServiceMetricResponse, ModifyApmAssociationRequest, DescribeGeneralOTSpanListResponse, DescribeApmApplicationConfigResponse, DescribeApmAssociationRequest, CreateProfileTaskRequest, DescribeApmVulnerabilityDetailRequest, DeleteApmSampleConfigResponse, DescribeApmPrometheusRuleRequest, CreateApmPrometheusRuleResponse, TerminateApmInstanceResponse, DescribeApmAgentResponse, CreateApmSampleConfigRequest, DescribeApmSampleConfigRequest, CreateApmSampleConfigResponse, ModifyApmAssociationResponse, DescribeGeneralSpanListRequest, DescribeApmAgentRequest, DescribeMetricRecordsRequest, DescribeGeneralMetricDataRequest, ModifyApmPrometheusRuleRequest, ModifyApmInstanceResponse, DescribeGeneralMetricDataResponse, ModifyApmInstanceRequest, DescribeApmInstancesResponse, DescribeApmPrometheusRuleResponse, ModifyApmSampleConfigResponse, DescribeApmApplicationConfigRequest, CreateProfileTaskResponse, DescribeApmVulnerabilityDetailResponse, ModifyApmPrometheusRuleResponse, DescribeMetricRecordsResponse, DescribeRelatedServicesOnTraceRequest, DescribeGeneralOTSpanListRequest, DescribeGeneralApmApplicationConfigResponse, CreateApmInstanceResponse, DescribeGeneralApmApplicationConfigRequest, DescribeTopologyNewRequest, DescribeApmInstancesRequest, DeleteApmSampleConfigRequest, DescribeApmVulnerabilityCountRequest, ModifyApmSampleConfigRequest, TerminateApmInstanceRequest, ModifyGeneralApmApplicationConfigRequest, DescribeApmServiceMetricRequest, CreateApmPrometheusRuleRequest, DescribeApmAllVulCountRequest, DescribeTagValuesResponse, DescribeGeneralSpanListResponse, DescribeApmSQLInjectionDetailRequest, ModifyApmServiceResponse, ModifyApmApplicationConfigRequest, ModifyGeneralApmApplicationConfigResponse, DescribeTagValuesRequest, ModifyApmServiceRequest, DescribeOPRAllVulCountRequest } from "./apm_models";
 /**
  * apm client
  * @class
@@ -23,6 +23,10 @@ export declare class Client extends AbstractClient {
      * 修改apm应用信息
      */
     ModifyApmService(req: ModifyApmServiceRequest, cb?: (error: string, rep: ModifyApmServiceResponse) => void): Promise<ModifyApmServiceResponse>;
+    /**
+     * 根据链路查询目标服务的上下游相关服务
+     */
+    DescribeRelatedServicesOnTrace(req: DescribeRelatedServicesOnTraceRequest, cb?: (error: string, rep: DescribeRelatedServicesOnTraceResponse) => void): Promise<DescribeRelatedServicesOnTraceResponse>;
     /**
      * 通用查询 OpenTelemetry 调用链列表
      */

package/tencentcloud/services/apm/v20210622/apm_client.js

@@ -51,6 +51,12 @@ class Client extends abstract_client_1.AbstractClient {
     async ModifyApmService(req, cb) {
         return this.request("ModifyApmService", req, cb);
     }
+    /**
+     * 根据链路查询目标服务的上下游相关服务
+     */
+    async DescribeRelatedServicesOnTrace(req, cb) {
+        return this.request("DescribeRelatedServicesOnTrace", req, cb);
+    }
     /**
      * 通用查询 OpenTelemetry 调用链列表
      */

package/tencentcloud/services/apm/v20210622/apm_models.d.ts

@@ -179,17 +179,30 @@ export interface SelectorView {
     Component?: ComponentTopologyView;
 }
 /**
- * DescribeApmSampleConfig请求参数结构体
+ * DescribeRelatedServicesOnTrace返回参数结构体
  */
-export interface DescribeApmSampleConfigRequest {
+export interface DescribeRelatedServicesOnTraceResponse {
     /**
-     * 业务系统ID
+     * 查询的总链路数
      */
-    InstanceId: string;
+    TotalTraces?: number;
     /**
-     * 采样规则名
+     * 查询到的应用的数量
      */
-    SampleName?: string;
+    TotalServices?: number;
+    /**
+     * 挑选的链路数量
+     */
+    SelectedTraces?: number;
+    /**
+     * 相关的服务/应用名列表
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ServiceRelations?: Array<ServiceRelation>;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
 }
 /**
  * DescribeApmAllVulCount返回参数结构体
@@ -874,37 +887,17 @@ export interface CreateApmSampleConfigRequest {
     OperationType?: number;
 }
 /**
- * DescribeTagValues请求参数结构体
+ * DescribeApmSampleConfig请求参数结构体
  */
-export interface DescribeTagValuesRequest {
+export interface DescribeApmSampleConfigRequest {
     /**
-     * 业务系统 ID
+     * 业务系统ID
      */
     InstanceId: string;
     /**
-     * 维度名
-     */
-    TagKey: string;
-    /**
-     * 开始时间（单位为秒）
-     */
-    StartTime: number;
-    /**
-     * 结束时间（单位为秒）
-     */
-    EndTime: number;
-    /**
-     * 过滤条件
-     */
-    Filters?: Array<Filter>;
-    /**
-     * Or 过滤条件
-     */
-    OrFilters?: Array<Filter>;
-    /**
-     * 使用类型
+     * 采样规则名
      */
-    Type?: string;
+    SampleName?: string;
 }
 /**
  * apm应用指标信息
@@ -1906,6 +1899,23 @@ export interface DescribeApmPrometheusRuleResponse {
      */
     RequestId?: string;
 }
+/**
+ * 应用对应的链路上下游应用集合
+ */
+export interface ServiceRelation {
+    /**
+     * 应用名
+     */
+    ServiceName?: string;
+    /**
+     * 上游应用集合
+     */
+    UpstreamServices?: Array<string>;
+    /**
+     * 下游应用集合
+     */
+    DownstreamServices?: Array<string>;
+}
 /**
  * ModifyApmSampleConfig返回参数结构体
  */
@@ -1998,45 +2008,29 @@ export interface ApmTag {
     Value: string;
 }
 /**
- * DescribeApmSQLInjectionDetail请求参数结构体
+ * DescribeRelatedServicesOnTrace请求参数结构体
  */
-export interface DescribeApmSQLInjectionDetailRequest {
+export interface DescribeRelatedServicesOnTraceRequest {
     /**
      * 业务系统 ID
      */
     InstanceId: string;
     /**
-     * 限制
-     */
-    Limit?: number;
-    /**
-     * 偏移量
-     */
-    Offset?: number;
-    /**
-     * 秒级时间戳
-     */
-    StartTime?: number;
-    /**
-     * 秒级时间戳
-     */
-    EndTime?: number;
-    /**
-     * 排序
+     * 查询开始时间
      */
-    OrderBy?: OrderBy;
+    StartTime: number;
     /**
-     * 查询过滤条件
+     * 查询结束时间
      */
-    Filters?: Array<Filter>;
+    EndTime: number;
     /**
-     * 聚合维度
+     * 应用名
      */
-    GroupBy?: Array<string>;
+    ServiceName?: string;
     /**
-     * 指标列表
+     * 是否为应用拓扑查询
      */
-    Metrics?: Array<QueryMetricItem>;
+    IsServiceTopology?: boolean;
 }
 /**
  * 查询过滤参数
@@ -3246,6 +3240,47 @@ export interface Resource {
      */
     CVMMeta?: Array<CVMMeta>;
 }
+/**
+ * DescribeApmSQLInjectionDetail请求参数结构体
+ */
+export interface DescribeApmSQLInjectionDetailRequest {
+    /**
+     * 业务系统 ID
+     */
+    InstanceId: string;
+    /**
+     * 限制
+     */
+    Limit?: number;
+    /**
+     * 偏移量
+     */
+    Offset?: number;
+    /**
+     * 秒级时间戳
+     */
+    StartTime?: number;
+    /**
+     * 秒级时间戳
+     */
+    EndTime?: number;
+    /**
+     * 排序
+     */
+    OrderBy?: OrderBy;
+    /**
+     * 查询过滤条件
+     */
+    Filters?: Array<Filter>;
+    /**
+     * 聚合维度
+     */
+    GroupBy?: Array<string>;
+    /**
+     * 指标列表
+     */
+    Metrics?: Array<QueryMetricItem>;
+}
 /**
  * 视图方案勾选情况
  */
@@ -3539,6 +3574,39 @@ export interface ModifyGeneralApmApplicationConfigResponse {
      */
     RequestId?: string;
 }
+/**
+ * DescribeTagValues请求参数结构体
+ */
+export interface DescribeTagValuesRequest {
+    /**
+     * 业务系统 ID
+     */
+    InstanceId: string;
+    /**
+     * 维度名
+     */
+    TagKey: string;
+    /**
+     * 开始时间（单位为秒）
+     */
+    StartTime: number;
+    /**
+     * 结束时间（单位为秒）
+     */
+    EndTime: number;
+    /**
+     * 过滤条件
+     */
+    Filters?: Array<Filter>;
+    /**
+     * Or 过滤条件
+     */
+    OrFilters?: Array<Filter>;
+    /**
+     * 使用类型
+     */
+    Type?: string;
+}
 /**
  * CVM元数据
  */

package/tencentcloud/services/cfs/v20190719/cfs_models.d.ts

@@ -1423,7 +1423,7 @@ export interface SetUserQuotaRequest {
      */
     CapacityHardLimit?: number;
     /**
-     * <p>文件硬限制，单位个。设置范围1000-100000000</p>
+     * <p>文件硬限制</p><p>取值范围：[1000, 1000000000]</p><p>单位：个</p><p>默认值：无默认值</p>
      */
     FileHardLimit?: number;
     /**

package/tencentcloud/services/ess/v20201111/ess_client.d.ts

@@ -21,16 +21,16 @@ export declare class Client extends AbstractClient {
     DescribeContractReviewTaskListWebUrl(req: DescribeContractReviewTaskListWebUrlRequest, cb?: (error: string, rep: DescribeContractReviewTaskListWebUrlResponse) => void): Promise<DescribeContractReviewTaskListWebUrlResponse>;
     /**
      * 此接口用于启动流程。它是模板发起合同的最后一步。
-在[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)和[创建电子文档](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument)之后，用于开始整个合同流程,  推进流程进入到签署环节。
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/1f38ebd7c5afed8763ad961741d81438.png)
 
-注：
-1.<font color="red">合同发起后就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）
+## 1.1 接口调用流程
+在[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)和[创建电子文档](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument)之后，用于开始整个合同流程,  推进流程进入到签署环节。
 
-2.<font color="red">静默（自动）签署不支持非本企业合同签署方存在填写</font>功能
+![image](https://qcloudimg.tencent-cloud.cn/raw/dbd2eba8200d812d76b7e9e34d739e75.svg)
 
-3.<font color="red">在发起签署流程之前，建议等待 [PDF合成完成的回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83)</font>，尤其是当模板中存在动态表格等复杂填写控件时，因为合成过程可能会耗费秒级别的时间。
+### 1.2 注意事项
+-  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/company/contract_cancel_quota)。
+-  只要存在填写控件，填充时会触发 PDF 合成工作，文档合成完成后会收到[合同文档合成完成回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83)。**一定要等待该回调（或等待数秒）后再调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 接口发起签署**，以确保文档已合成完毕。，尤其是当模板中存在动态表格等复杂填写控件时，因为合成过程可能会耗费秒级别的时间。
+- 调用 [CreateDocument](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument) 成功后，请<font color="red">在 5 分钟内调用本接口（StartFlow）启动合同</font> ，不要长时间暂存仅调用了 CreateDocument 而未发起的合同；否则会导致该合同长时间后无法再启动，且合同额度不再返还。
      */
     StartFlow(req: StartFlowRequest, cb?: (error: string, rep: StartFlowResponse) => void): Promise<StartFlowResponse>;
     /**
@@ -170,48 +170,42 @@ export declare class Client extends AbstractClient {
      */
     CreateFlowSignReview(req: CreateFlowSignReviewRequest, cb?: (error: string, rep: CreateFlowSignReviewResponse) => void): Promise<CreateFlowSignReviewResponse>;
     /**
-     * 创建签署流程电子文档<br />
-
-###  调用流程
-该接口需要给对应的流程指定一个模板id，并且填充该模板中需要补充的信息。需要配置<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。具体逻辑可以参考下图:
+     * 本接口用于基于**模板**创建合同的电子文档，并填充模板中由发起方补充的信息（归属发起方填写控件）。
 
-![image](https://qcloudimg.tencent-cloud.cn/raw/1f38ebd7c5afed8763ad961741d81438.png)
+### 1.1 调用流程
 
+本接口需指定一个模板 ID，并填充该模板中需补充的信息。它需要与<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口配合使用，完整调用顺序如下：
+![image](https://qcloudimg.tencent-cloud.cn/raw/dbd2eba8200d812d76b7e9e34d739e75.svg)
 
-### 填充模板中定义的填写控件
-模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充。
+### 1.2 发起方填写控件
 
-**<font color="red">填充填写控件需要进行Pdf合成工作，文档合成完成后会收到[合同文档合成完成回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83),建议在收到此回调后再调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 接口。</font>**
+模板中配置的<font color="red">发起人填充控件</font>，可通过本接口的 **FormFields 数组**字段填充。
 
 ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
 
-填充的传参示例如下
-
-```
-    request.FormFields = [{
-            "ComponentName": "项目的名字",
-            "ComponentValue": "休闲山庄"
-        }, {
-            "ComponentName": "项目的地址",
-            "ComponentValue": "凤凰山北侧",
-        }, {
-            "ComponentName": "范围",
-            "ComponentValue": "凤凰山至107国道",
-        }, {
-            "ComponentName": "面积",
-            "ComponentValue": "100亩",
-        }, {
-            "ComponentName": "基本情况",
-            "ComponentValue": "完好",
-        }, , {
-            "ComponentName": "用途",
-            "ComponentValue": "经营农家乐",
-        }
-    ]
+填充的传参示例如下（以 ComponentName 匹配模板中的控件名）：
+
+```json
+[
+    { "ComponentName": "项目的名字", "ComponentValue": "休闲山庄" },
+    { "ComponentName": "项目的地址", "ComponentValue": "凤凰山北侧" },
+    { "ComponentName": "范围", "ComponentValue": "凤凰山至107国道" },
+    { "ComponentName": "面积", "ComponentValue": "100亩" },
+    { "ComponentName": "基本情况", "ComponentValue": "完好" },
+    { "ComponentName": "用途", "ComponentValue": "经营农家乐" }
+]
 ```
-合成后合同样子示例
+
+合成后的合同样例：
 
 ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
+
+### 1.3 注意事项
+
+-  本接口<font color="red">只能填充分配给发起方的填写控件</font>，不能填充分配给签署方的签署控件。
+- <font color="red">若使用预览方式（`NeedPreview=true`），预览确认无误后，需用同样的参数再次调用本接口</font>（`NeedPreview=false`），并使用新调用返回的 `FlowId` 去调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 发起签署。预览模式返回的 `FlowId` 为临时 ID，不能用于发起。
+- 只要存在发起方的填写控件，填充时会触发 PDF 合成工作，文档合成完成后会收到[合同文档合成完成回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83)。<font color="red">一定要等待该回调（或等待数秒）后再调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 接口发起签署</font>，以确保文档已合成完毕。
+- 调用本接口（CreateDocument）成功后，请**在 5 分钟内调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 启动合同**，不要长时间暂存仅调用了 CreateDocument 而未发起的合同；否则会导致该合同长时间后无法再启动，且合同额度不再返还。
      */
     CreateDocument(req: CreateDocumentRequest, cb?: (error: string, rep: CreateDocumentResponse) => void): Promise<CreateDocumentResponse>;
     /**
@@ -661,40 +655,26 @@ export declare class Client extends AbstractClient {
     CreateFlowEvidenceReport(req: CreateFlowEvidenceReportRequest, cb?: (error: string, rep: CreateFlowEvidenceReportResponse) => void): Promise<CreateFlowEvidenceReportResponse>;
     /**
      * 通过模板创建签署流程<br/>
-适用场景：在标准制式的合同场景中，可通过提前预制好模板文件，每次调用模板文件的id，补充合同内容信息及签署信息生成电子合同。
-<table>
-    <thead>
-        <tr>
-            <th>签署人类别</th>
-            <th>需要提前准备的信息</th>
-        </tr>
-    </thead>
-    <tbody>
-        <tr>
-            <td>自己企业的员工签署（未认证加入或已认证加入）</td>
-            <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号（证件号非必传）</td>
-        </tr>
-        <tr>
-            <td>自己企业的员工签署（已认证加入）</td>
-            <td>签署企业的名字、员工在电子签平台的ID（UserId）</td>
-        </tr>
-        <tr>
-            <td>其他企业的员工签署</td>
-            <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号（证件号非必传）</td>
-        </tr>
-        <tr>
-            <td>个人（自然人）签署</td>
-            <td>个人的真实名字、个人的触达手机号、个人的身份证（证件号非必传）</td>
-        </tr>
-    </tbody>
-</table>
+适用场景：在标准制式的合同场景中，可通过提前预制好模板文件，每次使用这个配置好的模板，补充合同内容信息及签署信息生成电子合同。
+## 1.1 传参方式指引
 
+| 签署方类型 | ApproverType | 需要提前准备的信息 | 对应 Approvers 关键字段 |
+|------|------|------|------|
+| 本企业员工（未认证加入） | 0 | 签署企业名、员工真实姓名、员工触达手机号、证件号（非必传） | OrganizationName + ApproverName + ApproverMobile |
+| 本企业员工（已认证加入） | 0 | 签署企业名、员工在电子签平台的 ID（UserId） | OrganizationName + UserId |
+| 他方企业员工 | 0 | 签署企业名、员工真实姓名、员工触达手机号、证件号（非必传） | OrganizationName + ApproverName + ApproverMobile |
+| 个人（自然人） | 1 | 个人真实姓名、个人触达手机号、身份证号（非必传） | ApproverName + ApproverMobile |
 
-注：配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">创建电子文档</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。整体的逻辑如下图
+## 1.2 接口调用流程
+此接口需<font color="red">配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">创建电子文档</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用</font> 。整体的逻辑如下图
 
-![image](https://qcloudimg.tencent-cloud.cn/raw/1f38ebd7c5afed8763ad961741d81438.png)
+![image](https://qcloudimg.tencent-cloud.cn/raw/dbd2eba8200d812d76b7e9e34d739e75.svg)
 
-注：**静默（自动）签署不支持合同签署方存在填写**功能
+## 1.3 注意事项
+-  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/company/contract_cancel_quota)。
+- 支持的证件类型可以参考[支持的证件类型](https://qian.tencent.com/developers/company/id_card_support)。
+- 合同发起方需要【组织管理】->【角色管理】中拥有<font color="red">接口发起合同</font>的权限
+![image](https://qcloudimg.tencent-cloud.cn/raw/c8553d1823ca1323e82c11f01c86e8cd.png)
 <br>
 
 <font color="red">相关视频指引</font> <br>
@@ -865,7 +845,7 @@ export declare class Client extends AbstractClient {
 该接口需要依赖[上传文件](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口生成pdf资源编号（FileIds）进行使用。（如果非pdf文件需要调用[创建文件转换任务](https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFileConvertTask)接口转换成pdf资源）<br/>
 
 ## 整体流程图
-![image](https://qcloudimg.tencent-cloud.cn/raw/9577ac334c083ecfe0014a187d64b485.svg)
+![image](https://qcloudimg.tencent-cloud.cn/raw/9bf547fe0bc738f9a97b4b619dea0633.svg)
 
 注：
 -  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/company/contract_cancel_quota)。