tencentcloud-sdk-ess 3.0.996 → 3.0.998

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6a7ac5ba3c172e2b2c7664a50cb076291e1dc675
-  data.tar.gz: 0e2bc3e36d768ec7eb49cfecb89cba2ebbd48605
+  metadata.gz: ff80fe6e4e939262cc6be5b105020929719fe54e
+  data.tar.gz: c70084b7a66b97221c19ab8d33a899a0f51ec916
 SHA512:
-  metadata.gz: aadca64259b63c8de582419ce00f15128f74fdbf715f62da78692c0e1c6e4571c562c203a99f1d714d3d8b60a3bf2107fcd1376ea21b2fded3cd33f4a12358d1
-  data.tar.gz: 020e1b2bdb6b1bdcace65716aefe98cc60eba315f5d0f1101e9c3241eb9e3bc914af4049a4ba0392ae93a69e4a6a690784e9bc5461cbe868e5905b36fcb714f2
+  metadata.gz: af1acf4b964360e1c8fbfe6a2b1b0758d9baa37d0de128ced8084f75e0996aa50fff8b3438ef82fe39a539ada1863148d080e5287deeb3b5eee6b31eeadac004
+  data.tar.gz: eb09f4a914368c883234aa9666d6b6be8c8074c2836ec02fa96fd25ad6b8ef05dbe611464ebf2c9ba70b6f207c79927151acfe231962f8e71dbb4956be84a106

data/lib/VERSION

@@ -1 +1 @@
-3.0.996
+3.0.998

data/lib/v20201111/client.rb

@@ -620,6 +620,32 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 此接口用于发起数字文件CA加签操作。可以使用同步或者异步模式进行。
+
+        # **注意： 1. 文件类型暂时仅支持PDF类型文件。2. 此接口为『数字文件CA加签服务』白名单功能，使用前请联系对接的客户经理沟通。**
+
+        # @param request: Request instance for CreateFileCounterSign.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateFileCounterSignRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateFileCounterSignResponse`
+        def CreateFileCounterSign(request)
+          body = send_request('CreateFileCounterSign', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateFileCounterSignResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 通过模板创建签署流程<br/>
         # 适用场景：在标准制式的合同场景中，可通过提前预制好模板文件，每次调用模板文件的id，补充合同内容信息及签署信息生成电子合同。
         # <table>
@@ -2278,6 +2304,32 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 文件CA加签任务结果查询接口，用于查询 CreateFileCounterSign接口 发起的异步加签任务。
+
+        # 注意：`此接口为『数字文件CA加签服务』白名单功能，使用前请联系对接的客户经理沟通。`
+
+        # @param request: Request instance for DescribeFileCounterSignResult.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeFileCounterSignResultRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeFileCounterSignResultResponse`
+        def DescribeFileCounterSignResult(request)
+          body = send_request('DescribeFileCounterSignResult', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeFileCounterSignResultResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 本接口（DescribeFileUrls）用于查询文件的下载URL。
         # 适用场景：通过传参合同流程编号，下载对应的合同PDF文件流到本地。
 
@@ -3200,6 +3252,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 对加签后的文件进行数字签名验证，判断数字签名是否有效。
+
+        # @param request: Request instance for VerifyDigitFile.
+        # @type request: :class:`Tencentcloud::ess::V20201111::VerifyDigitFileRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::VerifyDigitFileResponse`
+        def VerifyDigitFile(request)
+          body = send_request('VerifyDigitFile', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = VerifyDigitFileResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 对合同流程文件进行数字签名验证，判断数字签名是否有效，合同文件内容是否被篡改。
 
 

data/lib/v20201111/models.rb

@@ -2646,6 +2646,79 @@ module TencentCloud
         end
       end
 
+      # CreateFileCounterSign请求参数结构体
+      class CreateFileCounterSignRequest < TencentCloud::Common::AbstractModel
+        # @param FileId: 需要加签的文件Id。
+
+        # 注: `暂时只支持pdf类型的文件`
+        # @type FileId: String
+        # @param Operator: 执行本接口操作的员工信息。注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Agent: 代理企业和员工的信息。在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param SyncMode: 是否使用同步模式。
+        # <ul><li><b>false</b>:异步模式，返回taskId。需要使用taskId轮询结果查询接口。</li>
+        # <li><b>true</b>: 同步模式，此接口将直接返回taskId和ResultFileId(加签后文件id)。</li></ul>
+        # 注：
+        # 1. 当加签文件较大的时候，建议使用异步接口进行操作。否则文件加签时间过长会导致接口超时。
+        # @type SyncMode: Boolean
+
+        attr_accessor :FileId, :Operator, :Agent, :SyncMode
+
+        def initialize(fileid=nil, operator=nil, agent=nil, syncmode=nil)
+          @FileId = fileid
+          @Operator = operator
+          @Agent = agent
+          @SyncMode = syncmode
+        end
+
+        def deserialize(params)
+          @FileId = params['FileId']
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @SyncMode = params['SyncMode']
+        end
+      end
+
+      # CreateFileCounterSign返回参数结构体
+      class CreateFileCounterSignResponse < TencentCloud::Common::AbstractModel
+        # @param Status: 加签任务的状态。
+
+        # <ul>
+        # <li><b>PROCESSING</b>: 任务正在执行中。</li>
+        # <li><b>FINISHED</b>: 已执行成功</li>
+        # </ul>
+        # @type Status: String
+        # @param ResultFileId: 加签完成后新的文件Id
+        # @type ResultFileId: String
+        # @param TaskId: 异步模式下用于轮询状态的任务Id
+        # @type TaskId: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Status, :ResultFileId, :TaskId, :RequestId
+
+        def initialize(status=nil, resultfileid=nil, taskid=nil, requestid=nil)
+          @Status = status
+          @ResultFileId = resultfileid
+          @TaskId = taskid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Status = params['Status']
+          @ResultFileId = params['ResultFileId']
+          @TaskId = params['TaskId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateFlowApprovers请求参数结构体
       class CreateFlowApproversRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
@@ -7303,27 +7376,78 @@ module TencentCloud
         end
       end
 
+      # DescribeFileCounterSignResult请求参数结构体
+      class DescribeFileCounterSignResultRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Agent: 代理企业和员工的信息。在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param TaskId: 加签任务Id
+        # @type TaskId: String
+
+        attr_accessor :Operator, :Agent, :TaskId
+
+        def initialize(operator=nil, agent=nil, taskid=nil)
+          @Operator = operator
+          @Agent = agent
+          @TaskId = taskid
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @TaskId = params['TaskId']
+        end
+      end
+
+      # DescribeFileCounterSignResult返回参数结构体
+      class DescribeFileCounterSignResultResponse < TencentCloud::Common::AbstractModel
+        # @param Status: 加签任务的状态。
+
+        # <ul>
+        # <li><b>PROCESSING</b>: 任务正在执行中。</li>
+        # <li><b>FINISHED</b>: 已执行成功</li>
+        # <li><b>FAILED</b>: 执行失败</li>
+        # </ul>
+        # @type Status: String
+        # @param ResultFileId: 加签完成后新的文件Id
+        # @type ResultFileId: String
+        # @param ErrorDetail: 失败的错误信息，加签任务失败的情况下会返回。
+        # @type ErrorDetail: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Status, :ResultFileId, :ErrorDetail, :RequestId
+
+        def initialize(status=nil, resultfileid=nil, errordetail=nil, requestid=nil)
+          @Status = status
+          @ResultFileId = resultfileid
+          @ErrorDetail = errordetail
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Status = params['Status']
+          @ResultFileId = params['ResultFileId']
+          @ErrorDetail = params['ErrorDetail']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeFileUrls请求参数结构体
       class DescribeFileUrlsRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
         # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param BusinessType: 文件对应的业务类型，目前支持：
-        # <ul>
-        # <li>**FLOW ** : <font color="red">如需下载合同文件请选择此项</font></li>
-        # <li>**TEMPLATE ** : 如需下载模板文件请选择此项</li>
-        # <li>**DOCUMENT  **: 如需下载文档文件请选择此项</li>
-        # <li>**SEAL  **: 如需下载印章图片请选择此项</li>
-        # </ul>
+        # @param BusinessType: 文件对应的业务类型，目前支持：<ul><li>**FLOW ** : <font color="red">如需下载合同文件请选择此项</font></li><li>**TEMPLATE ** : 如需下载模板文件请选择此项</li><li>**DOCUMENT  **: 如需下载文档文件请选择此项</li><li>**SEAL  **: 如需下载印章图片请选择此项</li><li>**DIGITFILE**: 如需下载加签文件请选择此项</li></ul>
         # @type BusinessType: String
-        # @param BusinessIds: 业务编号的数组，取值如下：
-        # <ul>
-        # <li>流程编号</li>
-        # <li>模板编号</li>
-        # <li>文档编号</li>
-        # <li>印章编号</li>
-        # <li>如需下载合同文件请传入FlowId，最大支持20个资源</li>
-        # </ul>
+        # @param BusinessIds: 业务编号的数组，取值如下：<ul><li>流程编号</li><li>模板编号</li><li>文档编号</li><li>印章编号</li><li>加签文件编号</li><li>如需下载合同文件请传入FlowId，最大支持20个资源</li></ul>
         # @type BusinessIds: Array
         # @param FileName: 下载后的文件命名，只有FileType为zip的时候生效
         # @type FileName: String
@@ -13239,6 +13363,121 @@ module TencentCloud
         end
       end
 
+      # VerifyDigitFile请求参数结构体
+      class VerifyDigitFileRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Agent: 代理企业和员工的信息。在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param FileId: 加签接口返回的文件Id
+        # @type FileId: String
+
+        attr_accessor :Operator, :Agent, :FileId
+
+        def initialize(operator=nil, agent=nil, fileid=nil)
+          @Operator = operator
+          @Agent = agent
+          @FileId = fileid
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @FileId = params['FileId']
+        end
+      end
+
+      # VerifyDigitFile返回参数结构体
+      class VerifyDigitFileResponse < TencentCloud::Common::AbstractModel
+        # @param PdfResourceMd5: 加签文件MD5哈希值
+        # @type PdfResourceMd5: String
+        # @param VerifyResult: 验签结果代码，代码的含义如下：<ul><li>**1**：文件验证成功。</li><li>**2**：文件验证失败。</li></ul>
+        # @type VerifyResult: Integer
+        # @param VerifySerialNo: 验签序列号, 为11为数组组成的字符串
+        # @type VerifySerialNo: String
+        # @param VerifyDigitFileResults: 验签结果详情，每个签名域对应的验签结果。
+        # @type VerifyDigitFileResults: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :PdfResourceMd5, :VerifyResult, :VerifySerialNo, :VerifyDigitFileResults, :RequestId
+
+        def initialize(pdfresourcemd5=nil, verifyresult=nil, verifyserialno=nil, verifydigitfileresults=nil, requestid=nil)
+          @PdfResourceMd5 = pdfresourcemd5
+          @VerifyResult = verifyresult
+          @VerifySerialNo = verifyserialno
+          @VerifyDigitFileResults = verifydigitfileresults
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @PdfResourceMd5 = params['PdfResourceMd5']
+          @VerifyResult = params['VerifyResult']
+          @VerifySerialNo = params['VerifySerialNo']
+          unless params['VerifyDigitFileResults'].nil?
+            @VerifyDigitFileResults = []
+            params['VerifyDigitFileResults'].each do |i|
+              verifydigitfileresult_tmp = VerifyDigitFileResult.new
+              verifydigitfileresult_tmp.deserialize(i)
+              @VerifyDigitFileResults << verifydigitfileresult_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # 数字加签文件验签结果
+      class VerifyDigitFileResult < TencentCloud::Common::AbstractModel
+        # @param CertNotBefore: 证书起始时间的Unix时间戳，单位毫秒
+        # @type CertNotBefore: Integer
+        # @param CertNotAfter: 证书过期时间的时间戳，单位毫秒
+        # @type CertNotAfter: Integer
+        # @param CertSn: 证书序列号，在数字证书申请过程中，系统会自动生成一个独一无二的序号。
+        # @type CertSn: String
+        # @param SignAlgorithm: 证书签名算法, 如SHA1withRSA等算法
+        # @type SignAlgorithm: String
+        # @param SignTime: 签署时间的Unix时间戳，单位毫秒
+        # @type SignTime: Integer
+        # @param SignType: 签名类型。0表示带签章的数字签名，1表示仅数字签名
+        # @type SignType: Integer
+        # @param SignerName: 申请证书的主体的名字
+
+        # 如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下
+        # **企业**:  ESS@企业名称@编码
+        # **个人**: ESS@个人姓名@证件号@808854
+
+        # 如果在其他平台签署的, 主体的名字参考其他平台的说明
+        # @type SignerName: String
+
+        attr_accessor :CertNotBefore, :CertNotAfter, :CertSn, :SignAlgorithm, :SignTime, :SignType, :SignerName
+
+        def initialize(certnotbefore=nil, certnotafter=nil, certsn=nil, signalgorithm=nil, signtime=nil, signtype=nil, signername=nil)
+          @CertNotBefore = certnotbefore
+          @CertNotAfter = certnotafter
+          @CertSn = certsn
+          @SignAlgorithm = signalgorithm
+          @SignTime = signtime
+          @SignType = signtype
+          @SignerName = signername
+        end
+
+        def deserialize(params)
+          @CertNotBefore = params['CertNotBefore']
+          @CertNotAfter = params['CertNotAfter']
+          @CertSn = params['CertSn']
+          @SignAlgorithm = params['SignAlgorithm']
+          @SignTime = params['SignTime']
+          @SignType = params['SignType']
+          @SignerName = params['SignerName']
+        end
+      end
+
       # VerifyPdf请求参数结构体
       class VerifyPdfRequest < TencentCloud::Common::AbstractModel
         # @param FlowId: 合同流程ID，为32位字符串。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.996
+  version: 3.0.998
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-02-11 00:00:00.000000000 Z
+date: 2025-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common