tencentcloud-sdk-nodejs 4.0.374 → 4.0.377

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/CHANGELOG.md +724 -0
  2. package/SERVICE_CHANGELOG.md +754 -29
  3. package/package.json +1 -1
  4. package/products.md +29 -29
  5. package/src/common/sdk_version.ts +1 -1
  6. package/src/services/antiddos/v20200309/antiddos_models.ts +1 -1
  7. package/src/services/as/v20180419/as_models.ts +3 -2
  8. package/src/services/cat/v20180409/cat_client.ts +1 -1
  9. package/src/services/cat/v20180409/cat_models.ts +17 -10
  10. package/src/services/cbs/v20170312/cbs_client.ts +1 -1
  11. package/src/services/cbs/v20170312/cbs_models.ts +23 -23
  12. package/src/services/cdb/v20170320/cdb_client.ts +21 -9
  13. package/src/services/cdb/v20170320/cdb_models.ts +96 -43
  14. package/src/services/ckafka/v20190819/ckafka_client.ts +1 -1
  15. package/src/services/ckafka/v20190819/ckafka_models.ts +17 -1
  16. package/src/services/clb/v20180317/clb_models.ts +4 -3
  17. package/src/services/cpdp/v20190820/cpdp_client.ts +80 -29
  18. package/src/services/cpdp/v20190820/cpdp_models.ts +470 -33
  19. package/src/services/cvm/v20170312/cvm_client.ts +721 -644
  20. package/src/services/cvm/v20170312/cvm_models.ts +429 -74
  21. package/src/services/cwp/v20180228/cwp_models.ts +6 -0
  22. package/src/services/cynosdb/v20190107/cynosdb_client.ts +109 -23
  23. package/src/services/cynosdb/v20190107/cynosdb_models.ts +437 -44
  24. package/src/services/dcdb/v20180411/dcdb_models.ts +15 -0
  25. package/src/services/dlc/v20210125/dlc_client.ts +15 -3
  26. package/src/services/dlc/v20210125/dlc_models.ts +207 -4
  27. package/src/services/es/v20180416/es_models.ts +12 -0
  28. package/src/services/ess/v20201111/ess_client.ts +36 -16
  29. package/src/services/ess/v20201111/ess_models.ts +9 -12
  30. package/src/services/essbasic/v20210526/essbasic_models.ts +37 -3
  31. package/src/services/ie/v20200304/ie_client.ts +5 -0
  32. package/src/services/ie/v20200304/ie_models.ts +261 -15
  33. package/src/services/mariadb/v20170312/mariadb_client.ts +25 -13
  34. package/src/services/mariadb/v20170312/mariadb_models.ts +53 -8
  35. package/src/services/oceanus/v20190422/oceanus_models.ts +5 -0
  36. package/src/services/redis/v20180412/redis_models.ts +6 -1
  37. package/src/services/tcss/v20201101/tcss_models.ts +13 -0
  38. package/src/services/tdcpg/v20211118/tdcpg_models.ts +42 -6
  39. package/src/services/tdmq/v20200217/tdmq_models.ts +2 -2
  40. package/src/services/teo/v20220106/teo_client.ts +7 -2
  41. package/src/services/teo/v20220106/teo_models.ts +236 -93
  42. package/src/services/tke/v20180525/tke_client.ts +5 -2
  43. package/src/services/tke/v20180525/tke_models.ts +111 -1
  44. package/src/services/vpc/v20170312/vpc_client.ts +1 -1
  45. package/src/services/wedata/v20210820/wedata_client.ts +14 -2
  46. package/src/services/wedata/v20210820/wedata_models.ts +72 -22
  47. package/tencentcloud/common/sdk_version.d.ts +1 -1
  48. package/tencentcloud/common/sdk_version.js +1 -1
  49. package/tencentcloud/services/antiddos/v20200309/antiddos_models.d.ts +1 -1
  50. package/tencentcloud/services/as/v20180419/as_models.d.ts +2 -1
  51. package/tencentcloud/services/cat/v20180409/cat_client.d.ts +1 -1
  52. package/tencentcloud/services/cat/v20180409/cat_client.js +1 -1
  53. package/tencentcloud/services/cat/v20180409/cat_models.d.ts +14 -7
  54. package/tencentcloud/services/cbs/v20170312/cbs_client.d.ts +1 -1
  55. package/tencentcloud/services/cbs/v20170312/cbs_client.js +1 -1
  56. package/tencentcloud/services/cbs/v20170312/cbs_models.d.ts +22 -22
  57. package/tencentcloud/services/cdb/v20170320/cdb_client.d.ts +7 -3
  58. package/tencentcloud/services/cdb/v20170320/cdb_client.js +9 -3
  59. package/tencentcloud/services/cdb/v20170320/cdb_models.d.ts +83 -35
  60. package/tencentcloud/services/ckafka/v20190819/ckafka_client.d.ts +1 -1
  61. package/tencentcloud/services/ckafka/v20190819/ckafka_models.d.ts +15 -1
  62. package/tencentcloud/services/clb/v20180317/clb_models.d.ts +2 -1
  63. package/tencentcloud/services/cpdp/v20190820/cpdp_client.d.ts +26 -10
  64. package/tencentcloud/services/cpdp/v20190820/cpdp_client.js +37 -13
  65. package/tencentcloud/services/cpdp/v20190820/cpdp_models.d.ts +406 -29
  66. package/tencentcloud/services/cvm/v20170312/cvm_client.d.ts +333 -306
  67. package/tencentcloud/services/cvm/v20170312/cvm_client.js +423 -384
  68. package/tencentcloud/services/cvm/v20170312/cvm_models.d.ts +372 -68
  69. package/tencentcloud/services/cwp/v20180228/cwp_models.d.ts +5 -0
  70. package/tencentcloud/services/cynosdb/v20190107/cynosdb_client.d.ts +35 -7
  71. package/tencentcloud/services/cynosdb/v20190107/cynosdb_client.js +51 -9
  72. package/tencentcloud/services/cynosdb/v20190107/cynosdb_models.d.ts +371 -41
  73. package/tencentcloud/services/dcdb/v20180411/dcdb_models.d.ts +12 -0
  74. package/tencentcloud/services/dlc/v20210125/dlc_client.d.ts +8 -4
  75. package/tencentcloud/services/dlc/v20210125/dlc_client.js +6 -0
  76. package/tencentcloud/services/dlc/v20210125/dlc_models.d.ts +174 -4
  77. package/tencentcloud/services/es/v20180416/es_models.d.ts +10 -0
  78. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +21 -1
  79. package/tencentcloud/services/ess/v20201111/ess_client.js +21 -1
  80. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +8 -11
  81. package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +31 -3
  82. package/tencentcloud/services/ie/v20200304/ie_models.d.ts +223 -14
  83. package/tencentcloud/services/mariadb/v20170312/mariadb_client.d.ts +12 -8
  84. package/tencentcloud/services/mariadb/v20170312/mariadb_client.js +14 -8
  85. package/tencentcloud/services/mariadb/v20170312/mariadb_models.d.ts +46 -8
  86. package/tencentcloud/services/oceanus/v20190422/oceanus_models.d.ts +4 -0
  87. package/tencentcloud/services/redis/v20180412/redis_models.d.ts +5 -1
  88. package/tencentcloud/services/tcss/v20201101/tcss_models.d.ts +11 -0
  89. package/tencentcloud/services/tdcpg/v20211118/tdcpg_models.d.ts +35 -5
  90. package/tencentcloud/services/tdmq/v20200217/tdmq_models.d.ts +2 -2
  91. package/tencentcloud/services/teo/v20220106/teo_models.d.ts +205 -82
  92. package/tencentcloud/services/tke/v20180525/tke_client.d.ts +2 -2
  93. package/tencentcloud/services/tke/v20180525/tke_client.js +1 -1
  94. package/tencentcloud/services/tke/v20180525/tke_models.d.ts +93 -1
  95. package/tencentcloud/services/vpc/v20170312/vpc_client.d.ts +1 -1
  96. package/tencentcloud/services/vpc/v20170312/vpc_client.js +1 -1
  97. package/tencentcloud/services/wedata/v20210820/wedata_client.d.ts +5 -1
  98. package/tencentcloud/services/wedata/v20210820/wedata_client.js +6 -0
  99. package/tencentcloud/services/wedata/v20210820/wedata_models.d.ts +62 -20
  100. package/test/cdb.v20170320.test.js +12 -2
  101. package/test/cpdp.v20190820.test.js +48 -8
  102. package/test/cvm.v20170312.test.js +212 -152
  103. package/test/cynosdb.v20190107.test.js +76 -6
  104. package/test/dlc.v20210125.test.js +10 -0
  105. package/test/mariadb.v20170312.test.js +12 -2
  106. package/test/wedata.v20210820.test.js +10 -0
@@ -159,6 +159,12 @@ class Client extends abstract_client_1.AbstractClient {
159
159
  async DeleteUsersFromWorkGroup(req, cb) {
160
160
  return this.request("DeleteUsersFromWorkGroup", req, cb);
161
161
  }
162
+ /**
163
+ * 上报元数据心跳
164
+ */
165
+ async ReportHeartbeatMetaData(req, cb) {
166
+ return this.request("ReportHeartbeatMetaData", req, cb);
167
+ }
162
168
  /**
163
169
  * 创建工作组
164
170
  */
@@ -140,10 +140,47 @@ export interface CreateStoreLocationResponse {
140
140
  */
141
141
  RequestId?: string;
142
142
  }
143
+ /**
144
+ * ReportHeartbeatMetaData请求参数结构体
145
+ */
146
+ export interface ReportHeartbeatMetaDataRequest {
147
+ /**
148
+ * 数据源名称
149
+ */
150
+ DatasourceConnectionName?: string;
151
+ /**
152
+ * 锁ID
153
+ */
154
+ LockId?: number;
155
+ /**
156
+ * 事务ID
157
+ */
158
+ TxnId?: number;
159
+ }
143
160
  /**
144
161
  * DescribeDMSDatabase返回参数结构体
145
162
  */
146
163
  export interface DescribeDMSDatabaseResponse {
164
+ /**
165
+ * 数据库名称
166
+ 注意:此字段可能返回 null,表示取不到有效值。
167
+ */
168
+ Name: string;
169
+ /**
170
+ * schema名称
171
+ 注意:此字段可能返回 null,表示取不到有效值。
172
+ */
173
+ SchemaName: string;
174
+ /**
175
+ * 存储地址
176
+ 注意:此字段可能返回 null,表示取不到有效值。
177
+ */
178
+ Location: string;
179
+ /**
180
+ * 数据对象
181
+ 注意:此字段可能返回 null,表示取不到有效值。
182
+ */
183
+ Asset: Asset;
147
184
  /**
148
185
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
149
186
  */
@@ -152,7 +189,20 @@ export interface DescribeDMSDatabaseResponse {
152
189
  /**
153
190
  * DropDMSDatabase请求参数结构体
154
191
  */
155
- export declare type DropDMSDatabaseRequest = null;
192
+ export interface DropDMSDatabaseRequest {
193
+ /**
194
+ * 数据库名称
195
+ */
196
+ Name: string;
197
+ /**
198
+ * 是否删除数据
199
+ */
200
+ DeleteData?: boolean;
201
+ /**
202
+ * 是否级联删除
203
+ */
204
+ Cascade?: boolean;
205
+ }
156
206
  /**
157
207
  * CreateScript返回参数结构体
158
208
  */
@@ -872,7 +922,68 @@ export interface CheckLockMetaDataRequest {
872
922
  /**
873
923
  * 元数据基本对象
874
924
  */
875
- export declare type Asset = null;
925
+ export interface Asset {
926
+ /**
927
+ * 主键
928
+ 注意:此字段可能返回 null,表示取不到有效值。
929
+ */
930
+ Id?: number;
931
+ /**
932
+ * 名称
933
+ 注意:此字段可能返回 null,表示取不到有效值。
934
+ */
935
+ Name?: string;
936
+ /**
937
+ * 对象GUID值
938
+ 注意:此字段可能返回 null,表示取不到有效值。
939
+ */
940
+ Guid?: string;
941
+ /**
942
+ * 数据目录
943
+ 注意:此字段可能返回 null,表示取不到有效值。
944
+ */
945
+ Catalog?: string;
946
+ /**
947
+ * 描述信息
948
+ */
949
+ Description?: string;
950
+ /**
951
+ * 对象owner
952
+ */
953
+ Owner?: string;
954
+ /**
955
+ * 对象owner账户
956
+ */
957
+ OwnerAccount?: string;
958
+ /**
959
+ * 权限
960
+ */
961
+ PermValues?: Array<KVPair>;
962
+ /**
963
+ * 附加属性
964
+ */
965
+ Params?: Array<KVPair>;
966
+ /**
967
+ * 附加业务属性
968
+ */
969
+ BizParams?: Array<KVPair>;
970
+ /**
971
+ * 数据版本
972
+ */
973
+ DataVersion?: number;
974
+ /**
975
+ * 创建时间
976
+ */
977
+ CreateTime?: string;
978
+ /**
979
+ * 修改时间
980
+ */
981
+ ModifiedTime?: string;
982
+ /**
983
+ * 数据源主键
984
+ */
985
+ DatasourceId?: number;
986
+ }
876
987
  /**
877
988
  * CreateDatabase返回参数结构体
878
989
  */
@@ -1199,6 +1310,10 @@ export interface DescribeDMSPartitionsRequest {
1199
1310
  * 页面数量
1200
1311
  */
1201
1312
  Limit?: number;
1313
+ /**
1314
+ * 表达式
1315
+ */
1316
+ Expression?: string;
1202
1317
  }
1203
1318
  /**
1204
1319
  * DescribeSparkAppJobs请求参数结构体
@@ -1518,6 +1633,15 @@ export interface CreateExportTaskRequest {
1518
1633
  */
1519
1634
  OutputType?: string;
1520
1635
  }
1636
+ /**
1637
+ * ReportHeartbeatMetaData返回参数结构体
1638
+ */
1639
+ export interface ReportHeartbeatMetaDataResponse {
1640
+ /**
1641
+ * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1642
+ */
1643
+ RequestId?: string;
1644
+ }
1521
1645
  /**
1522
1646
  * CreateDMSTable请求参数结构体
1523
1647
  */
@@ -2189,6 +2313,10 @@ export interface AlterDMSTableRequest {
2189
2313
  * 分区
2190
2314
  */
2191
2315
  Partitions?: Array<DMSPartition>;
2316
+ /**
2317
+ * 当前表名
2318
+ */
2319
+ Name?: string;
2192
2320
  }
2193
2321
  /**
2194
2322
  * CreateImportTask返回参数结构体
@@ -2832,7 +2960,20 @@ export interface UnbindWorkGroupsFromUserRequest {
2832
2960
  /**
2833
2961
  * DescribeDMSDatabase请求参数结构体
2834
2962
  */
2835
- export declare type DescribeDMSDatabaseRequest = null;
2963
+ export interface DescribeDMSDatabaseRequest {
2964
+ /**
2965
+ * 数据库名称
2966
+ */
2967
+ Name?: string;
2968
+ /**
2969
+ * schema名称
2970
+ */
2971
+ SchemaName?: string;
2972
+ /**
2973
+ * 匹配规则
2974
+ */
2975
+ Pattern?: string;
2976
+ }
2836
2977
  /**
2837
2978
  * DescribeTable请求参数结构体
2838
2979
  */
@@ -3494,7 +3635,24 @@ export interface CheckLockMetaDataResponse {
3494
3635
  /**
3495
3636
  * AlterDMSDatabase请求参数结构体
3496
3637
  */
3497
- export declare type AlterDMSDatabaseRequest = null;
3638
+ export interface AlterDMSDatabaseRequest {
3639
+ /**
3640
+ * 当前名称
3641
+ */
3642
+ CurrentName?: string;
3643
+ /**
3644
+ * schema名称
3645
+ */
3646
+ SchemaName?: string;
3647
+ /**
3648
+ * 路径
3649
+ */
3650
+ Location?: string;
3651
+ /**
3652
+ * 基础对象
3653
+ */
3654
+ Asset?: Asset;
3655
+ }
3498
3656
  /**
3499
3657
  * SQL查询任务
3500
3658
  */
@@ -3560,6 +3718,18 @@ export interface AttachUserPolicyResponse {
3560
3718
  * CreateDMSDatabase请求参数结构体
3561
3719
  */
3562
3720
  export interface CreateDMSDatabaseRequest {
3721
+ /**
3722
+ * 基础元数据对象
3723
+ */
3724
+ Asset?: Asset;
3725
+ /**
3726
+ * Schema目录
3727
+ */
3728
+ SchemaName?: string;
3729
+ /**
3730
+ * Db存储路径
3731
+ */
3732
+ Location?: string;
3563
3733
  /**
3564
3734
  * 数据库名称
3565
3735
  */
@@ -124,6 +124,16 @@ export interface NodeInfo {
124
124
  * 节点磁盘是否加密 0: 不加密,1: 加密;默认不加密
125
125
  */
126
126
  DiskEncrypt?: number;
127
+ /**
128
+ * cpu数目
129
+ 注意:此字段可能返回 null,表示取不到有效值。
130
+ */
131
+ CpuNum?: number;
132
+ /**
133
+ * 内存大小,单位GB
134
+ 注意:此字段可能返回 null,表示取不到有效值。
135
+ */
136
+ MemSize?: number;
127
137
  }
128
138
  /**
129
139
  * UpgradeInstance返回参数结构体
@@ -9,23 +9,30 @@ export declare class Client extends AbstractClient {
9
9
  constructor(clientConfig: ClientConfig);
10
10
  /**
11
11
  * 此接口用于发起流程
12
+ 适用场景:见创建签署流程接口。
13
+ 注:该接口是“创建电子文档”接口的后置接口,用于激活包含完整合同信息(模板及内容信息)的流程。激活后的流程就是一份待签署的电子合同。
12
14
  */
13
15
  StartFlow(req: StartFlowRequest, cb?: (error: string, rep: StartFlowResponse) => void): Promise<StartFlowResponse>;
14
16
  /**
15
17
  * 此接口(CreateMultiFlowSignQRCode)用于创建一码多扫流程签署二维码。
18
+ 适用场景:无需填写签署人信息,可通过模板id生成签署二维码,签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
16
19
  适用的模板仅限于B2C(1、无序签署,2、顺序签署时B静默签署,3、顺序签署时B非首位签署)、单C的模板,且模板中发起方没有填写控件。
17
20
  */
18
21
  CreateMultiFlowSignQRCode(req: CreateMultiFlowSignQRCodeRequest, cb?: (error: string, rep: CreateMultiFlowSignQRCodeResponse) => void): Promise<CreateMultiFlowSignQRCodeResponse>;
19
22
  /**
20
23
  * 用于撤销签署流程
24
+ 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
25
+ 注:如果合同流程中的参与方均已签署完毕,则无法通过该接口撤销合同。
21
26
  */
22
27
  CancelFlow(req: CancelFlowRequest, cb?: (error: string, rep: CancelFlowResponse) => void): Promise<CancelFlowResponse>;
23
28
  /**
24
29
  * 创建电子文档
30
+ 适用场景:见创建签署流程接口。 注:该接口需要给对应的流程指定一个模板id,并且填充该模板中需要补充的信息。是“发起流程”接口的前置接口。
25
31
  */
26
32
  CreateDocument(req: CreateDocumentRequest, cb?: (error: string, rep: CreateDocumentResponse) => void): Promise<CreateDocumentResponse>;
27
33
  /**
28
34
  * 查询文件下载URL
35
+ 适用场景:通过传参合同流程编号,下载对应的合同PDF文件流到本地。
29
36
  */
30
37
  DescribeFileUrls(req: DescribeFileUrlsRequest, cb?: (error: string, rep: DescribeFileUrlsResponse) => void): Promise<DescribeFileUrlsResponse>;
31
38
  /**
@@ -34,6 +41,8 @@ export declare class Client extends AbstractClient {
34
41
  DescribeThirdPartyAuthCode(req: DescribeThirdPartyAuthCodeRequest, cb?: (error: string, rep: DescribeThirdPartyAuthCodeResponse) => void): Promise<DescribeThirdPartyAuthCodeResponse>;
35
42
  /**
36
43
  * 创建签署流程
44
+ 适用场景:在标准制式的合同场景中,可通过提前预制好模板文件,每次调用模板文件的id,补充合同内容信息及签署信息生成电子合同。
45
+ 注:改接口是通过模板生成合同流程的前置接口,先创建一个不包含签署文件的流程。配合“创建电子文档”接口和“发起流程”接口使用。
37
46
  */
38
47
  CreateFlow(req: CreateFlowRequest, cb?: (error: string, rep: CreateFlowResponse) => void): Promise<CreateFlowResponse>;
39
48
  /**
@@ -43,6 +52,11 @@ export declare class Client extends AbstractClient {
43
52
  /**
44
53
  * 获取小程序跳转链接
45
54
 
55
+ 适用场景:如果需要签署人在自己的APP、小程序、H5应用中签署,可以通过此接口获取跳转腾讯电子签小程序的签署跳转链接。
56
+
57
+ 注:如果签署人是在PC端扫码签署,可以通过生成跳转链接自主转换成二维码,让签署人在PC端扫码签署。
58
+
59
+
46
60
  跳转到小程序的实现,参考官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式)
47
61
 
48
62
 
@@ -51,18 +65,24 @@ export declare class Client extends AbstractClient {
51
65
  CreateSchemeUrl(req: CreateSchemeUrlRequest, cb?: (error: string, rep: CreateSchemeUrlResponse) => void): Promise<CreateSchemeUrlResponse>;
52
66
  /**
53
67
  * 二期接口-查询模板
68
+ 适用场景:当模板较多或模板中的控件较多时,可以通过查询模板接口更方便的获取自己主体下的模板列表,以及每个模板内的控件信息。该接口常用来配合“创建电子文档”接口作为前置的接口使用。
54
69
  */
55
70
  DescribeFlowTemplates(req: DescribeFlowTemplatesRequest, cb?: (error: string, rep: DescribeFlowTemplatesResponse) => void): Promise<DescribeFlowTemplatesResponse>;
56
71
  /**
57
72
  * 查询流程摘要
73
+ 适用场景:可用于主动查询某个合同流程的签署状态信息。可以配合回调通知使用。
58
74
  */
59
75
  DescribeFlowBriefs(req: DescribeFlowBriefsRequest, cb?: (error: string, rep: DescribeFlowBriefsResponse) => void): Promise<DescribeFlowBriefsResponse>;
60
76
  /**
61
- * 此接口(CreateFlowByFiles)用来通过上传后的pdf资源编号来创建签署流程。
77
+ * 此接口(CreateFlowByFiles)用来通过上传后的pdf资源编号来创建待签署的合同流程。
78
+ 适用场景1:适用非制式的合同文件签署。一般开发者自己有完整的签署文件,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
79
+ 适用场景2:可通过改接口传入制式合同文件,同时在指定位置添加签署控件。可以起到接口创建临时模板的效果。如果是标准的制式文件,建议使用模板功能生成模板ID进行合同流程的生成。
80
+ 注意事项:该接口需要依赖“多文件上传”接口生成pdf资源编号(FileIds)进行使用。
62
81
  */
63
82
  CreateFlowByFiles(req: CreateFlowByFilesRequest, cb?: (error: string, rep: CreateFlowByFilesResponse) => void): Promise<CreateFlowByFilesResponse>;
64
83
  /**
65
84
  * 此接口(UploadFiles)用于文件上传。
85
+ 适用场景:用于生成pdf资源编号(FileIds)来配合“用PDF创建流程”接口使用,使用场景可详见“用PDF创建流程”接口说明。
66
86
  调用时需要设置Domain 为 file.ess.tencent.cn,设置Version为2020-12-22
67
87
  */
68
88
  UploadFiles(req: UploadFilesRequest, cb?: (error: string, rep: UploadFilesResponse) => void): Promise<UploadFilesResponse>;
@@ -29,12 +29,15 @@ class Client extends abstract_client_1.AbstractClient {
29
29
  }
30
30
  /**
31
31
  * 此接口用于发起流程
32
+ 适用场景:见创建签署流程接口。
33
+ 注:该接口是“创建电子文档”接口的后置接口,用于激活包含完整合同信息(模板及内容信息)的流程。激活后的流程就是一份待签署的电子合同。
32
34
  */
33
35
  async StartFlow(req, cb) {
34
36
  return this.request("StartFlow", req, cb);
35
37
  }
36
38
  /**
37
39
  * 此接口(CreateMultiFlowSignQRCode)用于创建一码多扫流程签署二维码。
40
+ 适用场景:无需填写签署人信息,可通过模板id生成签署二维码,签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
38
41
  适用的模板仅限于B2C(1、无序签署,2、顺序签署时B静默签署,3、顺序签署时B非首位签署)、单C的模板,且模板中发起方没有填写控件。
39
42
  */
40
43
  async CreateMultiFlowSignQRCode(req, cb) {
@@ -42,18 +45,22 @@ class Client extends abstract_client_1.AbstractClient {
42
45
  }
43
46
  /**
44
47
  * 用于撤销签署流程
48
+ 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
49
+ 注:如果合同流程中的参与方均已签署完毕,则无法通过该接口撤销合同。
45
50
  */
46
51
  async CancelFlow(req, cb) {
47
52
  return this.request("CancelFlow", req, cb);
48
53
  }
49
54
  /**
50
55
  * 创建电子文档
56
+ 适用场景:见创建签署流程接口。 注:该接口需要给对应的流程指定一个模板id,并且填充该模板中需要补充的信息。是“发起流程”接口的前置接口。
51
57
  */
52
58
  async CreateDocument(req, cb) {
53
59
  return this.request("CreateDocument", req, cb);
54
60
  }
55
61
  /**
56
62
  * 查询文件下载URL
63
+ 适用场景:通过传参合同流程编号,下载对应的合同PDF文件流到本地。
57
64
  */
58
65
  async DescribeFileUrls(req, cb) {
59
66
  return this.request("DescribeFileUrls", req, cb);
@@ -66,6 +73,8 @@ class Client extends abstract_client_1.AbstractClient {
66
73
  }
67
74
  /**
68
75
  * 创建签署流程
76
+ 适用场景:在标准制式的合同场景中,可通过提前预制好模板文件,每次调用模板文件的id,补充合同内容信息及签署信息生成电子合同。
77
+ 注:改接口是通过模板生成合同流程的前置接口,先创建一个不包含签署文件的流程。配合“创建电子文档”接口和“发起流程”接口使用。
69
78
  */
70
79
  async CreateFlow(req, cb) {
71
80
  return this.request("CreateFlow", req, cb);
@@ -79,6 +88,11 @@ class Client extends abstract_client_1.AbstractClient {
79
88
  /**
80
89
  * 获取小程序跳转链接
81
90
 
91
+ 适用场景:如果需要签署人在自己的APP、小程序、H5应用中签署,可以通过此接口获取跳转腾讯电子签小程序的签署跳转链接。
92
+
93
+ 注:如果签署人是在PC端扫码签署,可以通过生成跳转链接自主转换成二维码,让签署人在PC端扫码签署。
94
+
95
+
82
96
  跳转到小程序的实现,参考官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式)
83
97
 
84
98
 
@@ -89,24 +103,30 @@ class Client extends abstract_client_1.AbstractClient {
89
103
  }
90
104
  /**
91
105
  * 二期接口-查询模板
106
+ 适用场景:当模板较多或模板中的控件较多时,可以通过查询模板接口更方便的获取自己主体下的模板列表,以及每个模板内的控件信息。该接口常用来配合“创建电子文档”接口作为前置的接口使用。
92
107
  */
93
108
  async DescribeFlowTemplates(req, cb) {
94
109
  return this.request("DescribeFlowTemplates", req, cb);
95
110
  }
96
111
  /**
97
112
  * 查询流程摘要
113
+ 适用场景:可用于主动查询某个合同流程的签署状态信息。可以配合回调通知使用。
98
114
  */
99
115
  async DescribeFlowBriefs(req, cb) {
100
116
  return this.request("DescribeFlowBriefs", req, cb);
101
117
  }
102
118
  /**
103
- * 此接口(CreateFlowByFiles)用来通过上传后的pdf资源编号来创建签署流程。
119
+ * 此接口(CreateFlowByFiles)用来通过上传后的pdf资源编号来创建待签署的合同流程。
120
+ 适用场景1:适用非制式的合同文件签署。一般开发者自己有完整的签署文件,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
121
+ 适用场景2:可通过改接口传入制式合同文件,同时在指定位置添加签署控件。可以起到接口创建临时模板的效果。如果是标准的制式文件,建议使用模板功能生成模板ID进行合同流程的生成。
122
+ 注意事项:该接口需要依赖“多文件上传”接口生成pdf资源编号(FileIds)进行使用。
104
123
  */
105
124
  async CreateFlowByFiles(req, cb) {
106
125
  return this.request("CreateFlowByFiles", req, cb);
107
126
  }
108
127
  /**
109
128
  * 此接口(UploadFiles)用于文件上传。
129
+ 适用场景:用于生成pdf资源编号(FileIds)来配合“用PDF创建流程”接口使用,使用场景可详见“用PDF创建流程”接口说明。
110
130
  调用时需要设置Domain 为 file.ess.tencent.cn,设置Version为2020-12-22
111
131
  */
112
132
  async UploadFiles(req, cb) {
@@ -338,20 +338,17 @@ export interface SignQrCode {
338
338
  * UploadFiles请求参数结构体
339
339
  */
340
340
  export interface UploadFilesRequest {
341
- /**
342
- * 调用方信息
343
- */
344
- Caller: Caller;
345
341
  /**
346
342
  * 文件对应业务类型,用于区分文件存储路径:
347
343
  1. TEMPLATE - 模板; 文件类型:.pdf/.html
348
344
  2. DOCUMENT - 签署过程及签署后的合同文档 文件类型:.pdf/.html
349
- 3. FLOW - 签署过程 文件类型:.pdf/.html
350
- 4. SEAL - 印章; 文件类型:.jpg/.jpeg/.png
351
- 5. BUSINESSLICENSE - 营业执照 文件类型:.jpg/.jpeg/.png
352
- 6. IDCARD - 身份证 文件类型:.jpg/.jpeg/.png
345
+ 3. SEAL - 印章; 文件类型:.jpg/.jpeg/.png
353
346
  */
354
347
  BusinessType: string;
348
+ /**
349
+ * 调用方信息
350
+ */
351
+ Caller?: Caller;
355
352
  /**
356
353
  * 上传文件内容数组,最多支持20个文件
357
354
  */
@@ -361,14 +358,14 @@ export interface UploadFilesRequest {
361
358
  */
362
359
  FileUrls?: string;
363
360
  /**
364
- * 是否将pdf灰色矩阵置白
361
+ * 此参数只对 PDF 文件有效。是否将pdf灰色矩阵置白
365
362
  true--是,处理置白
366
363
  false--否,不处理
367
364
  */
368
365
  CoverRect?: boolean;
369
366
  /**
370
- * 特殊文件类型需要指定文件类型:
371
- HTML-- .html文件
367
+ * 文件类型, 默认通过文件内容解析得到文件类型,客户可以显示的说明上传文件的类型。
368
+ 如:PDF 表示上传的文件 xxx.pdf的文件类型是 PDF
372
369
  */
373
370
  FileType?: string;
374
371
  /**
@@ -350,17 +350,45 @@ export interface CreateSignUrlsRequest {
350
350
  */
351
351
  FlowIds: Array<string>;
352
352
  /**
353
- * 签署链接类型:“WEIXINAPP”-直接跳小程序;“CHANNEL”-跳转H5页面;“APP”-第三方APP或小程序跳转电子签小程序;默认“WEIXINAPP”类型,即跳转至小程序。
353
+ * 签署链接类型:“WEIXINAPP”-直接跳小程序;“CHANNEL”-跳转H5页面;“APP”-第三方APP或小程序跳转电子签小程序;默认“WEIXINAPP”类型,即跳转至小程序;
354
354
  */
355
355
  Endpoint?: string;
356
356
  /**
357
- * 签署完之后的H5页面的跳转链接,针对Endpoint为CHANNEL时有效,最大长度1000个字符。
357
+ * 签署链接生成类型,默认是 "ALL";
358
+ "ALL":全部签署方签署链接;
359
+ "CHANNEL":渠道合作企业;
360
+ "NOT_CHANNEL":非渠道合作企业;
361
+ "PERSON":个人;
358
362
  */
359
- JumpUrl?: string;
363
+ GenerateType?: string;
364
+ /**
365
+ * 非渠道合作企业参与方的企业名称,GenerateType为"NOT_CHANNEL"时必填
366
+ */
367
+ OrganizationName?: string;
368
+ /**
369
+ * 参与人姓名,GenerateType为"PERSON"时必填
370
+ */
371
+ Name?: string;
372
+ /**
373
+ * 参与人手机号,GenerateType为"PERSON"时必填
374
+ */
375
+ Mobile?: string;
376
+ /**
377
+ * 渠道合作企业的企业Id,GenerateType为"CHANNEL"时必填
378
+ */
379
+ OrganizationOpenId?: string;
380
+ /**
381
+ * 渠道合作企业参与人OpenId,GenerateType为"CHANNEL"时可用,指定到具体参与人
382
+ */
383
+ OpenId?: string;
360
384
  /**
361
385
  * Endpoint为"APP" 类型的签署链接,可以设置此值;支持调用方小程序打开签署链接,在电子签小程序完成签署后自动回跳至调用方小程序
362
386
  */
363
387
  AutoJumpBack?: boolean;
388
+ /**
389
+ * 签署完之后的H5页面的跳转链接,针对Endpoint为CHANNEL时有效,最大长度1000个字符。
390
+ */
391
+ JumpUrl?: string;
364
392
  /**
365
393
  * 操作者的信息
366
394
  */