tencentcloud-sdk-faceid 3.0.789 → 3.0.791

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7b9e70dafa1b933c92c7ae5fec12ed1e351e0226
-  data.tar.gz: 2e75b2822cfb0bddc24920d01ee6b62ab1b10326
+  metadata.gz: c10face720dffcb11f51397637fba0b6dc0bd1b0
+  data.tar.gz: eeef0a5ebc5cf6e8bc2c56e2dfa4388e7c27c6ef
 SHA512:
-  metadata.gz: e408f49f554055bde3d89eb377af5825d37add0c8372807696b60aed7743a623b5e40fa2da7dff0c105b00f4c35021c98b04ced05d2639976552dcb5b7849745
-  data.tar.gz: b48ba03876d0eb4ade43795c26b52f11da535e57b5cb6421ca70d3dedd3b79b9af13402a32e3bd2d8bb019015f7979f388e763365bbcb18300fb1340248a5d46
+  metadata.gz: 346cd6a16f471b8c142b3c65090640d3e11d2ef1ddcebb21b2b72154b2f7b39765dc0d23d7bca008366bf17f1776db7ac27394b2378cb09041039840cd25e231
+  data.tar.gz: d8192d5b33c61580247fab7308f1016423efe9c14790bd8237a5b2337fb2785acb67bae56f8a50c88df2691625f9d2506e7f7b9268dbdddc4273a59784790772

data/lib/VERSION

@@ -1 +1 @@
-3.0.789
+3.0.791

data/lib/v20180301/client.rb

@@ -437,6 +437,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 完成验证后，用FaceIdToken调用本接口获取设备风险相关信息，FaceIdToken生成后三天内（3\*24\*3,600秒）可多次拉取。
+
+        # @param request: Request instance for GetFaceIdRiskInfo.
+        # @type request: :class:`Tencentcloud::faceid::V20180301::GetFaceIdRiskInfoRequest`
+        # @rtype: :class:`Tencentcloud::faceid::V20180301::GetFaceIdRiskInfoResponse`
+        def GetFaceIdRiskInfo(request)
+          body = send_request('GetFaceIdRiskInfo', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = GetFaceIdRiskInfoResponse.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
+
         # 每次调用人脸核身SDK服务前，需先调用本接口获取SDKToken，用来串联核身流程，在验证完成后，用于获取验证结果信息，该token仅能核身一次。
 
         # @param request: Request instance for GetFaceIdToken.
@@ -461,6 +485,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 每次调用人脸核身SDK服务前，需先调用本接口获取SDKToken，用来串联核身流程，在验证完成后，用于获取风险结果信息，该Token仅能核身一次。
+
+        # @param request: Request instance for GetFaceidRiskInfoToken.
+        # @type request: :class:`Tencentcloud::faceid::V20180301::GetFaceidRiskInfoTokenRequest`
+        # @rtype: :class:`Tencentcloud::faceid::V20180301::GetFaceidRiskInfoTokenResponse`
+        def GetFaceidRiskInfoToken(request)
+          body = send_request('GetFaceidRiskInfoToken', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = GetFaceidRiskInfoTokenResponse.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
+
         # 使用数字活体检测模式前，需调用本接口获取数字验证码。
 
         # @param request: Request instance for GetLiveCode.

data/lib/v20180301/models.rb

@@ -2006,6 +2006,68 @@ module TencentCloud
         end
       end
 
+      # GetFaceIdRiskInfo请求参数结构体
+      class GetFaceIdRiskInfoRequest < TencentCloud::Common::AbstractModel
+        # @param FaceIdToken: SDK人脸核身流程的标识，调用GetFaceidRiskInfoToken接口时生成。
+        # @type FaceIdToken: String
+
+        attr_accessor :FaceIdToken
+
+        def initialize(faceidtoken=nil)
+          @FaceIdToken = faceidtoken
+        end
+
+        def deserialize(params)
+          @FaceIdToken = params['FaceIdToken']
+        end
+      end
+
+      # GetFaceIdRiskInfo返回参数结构体
+      class GetFaceIdRiskInfoResponse < TencentCloud::Common::AbstractModel
+        # @param DeviceInfoTag: 描述当前请求所在设备的风险标签，详情如下： 01-设备疑似被Root/设备疑似越狱 02-设备疑似被注入 03-设备疑似为模拟器 04-设备疑似存在风险操作 05-摄像头疑似被劫持 06-疑似黑产设备
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DeviceInfoTag: String
+        # @param DeviceInfoLevel: 描述当前请求所在设备的风险等级，共4级，详情如下： 1 - 安全 2 - 低风险 3 - 中风险 4 - 高危 ，-1表示未获取到风险等级
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DeviceInfoLevel: Integer
+        # @param OpenId: 设备id标识
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OpenId: String
+        # @param CameraInfoLevel: 描述当前请求所在设备的相机指纹风险等级，共4级，详情如下： 1 - 安全 2 - 低风险 3 - 中风险 4 - 高危 ，-1表示未获取到风险等级
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CameraInfoLevel: Integer
+        # @param CameraInfoTag: 描述当前请求所在设备的相机指纹风险标签，详情如下： 01-设备疑似被Root/设备疑似越狱 02-设备疑似被注入 03-设备疑似为模拟器 04-设备疑似存在风险操作 05-摄像头疑似被劫持 06-疑似黑产设备，空表示没有相机指纹风险
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CameraInfoTag: String
+        # @param Extra: 获取token时透传的信息
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Extra: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :DeviceInfoTag, :DeviceInfoLevel, :OpenId, :CameraInfoLevel, :CameraInfoTag, :Extra, :RequestId
+
+        def initialize(deviceinfotag=nil, deviceinfolevel=nil, openid=nil, camerainfolevel=nil, camerainfotag=nil, extra=nil, requestid=nil)
+          @DeviceInfoTag = deviceinfotag
+          @DeviceInfoLevel = deviceinfolevel
+          @OpenId = openid
+          @CameraInfoLevel = camerainfolevel
+          @CameraInfoTag = camerainfotag
+          @Extra = extra
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @DeviceInfoTag = params['DeviceInfoTag']
+          @DeviceInfoLevel = params['DeviceInfoLevel']
+          @OpenId = params['OpenId']
+          @CameraInfoLevel = params['CameraInfoLevel']
+          @CameraInfoTag = params['CameraInfoTag']
+          @Extra = params['Extra']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # GetFaceIdToken请求参数结构体
       class GetFaceIdTokenRequest < TencentCloud::Common::AbstractModel
         # @param CompareLib: 本地上传照片(LOCAL)、商业库(BUSINESS)
@@ -2026,10 +2088,13 @@ module TencentCloud
         # @type UseCos: Boolean
         # @param Encryption: 敏感数据加密信息。对传入信息（姓名、身份证号）有加密需求的用户可使用此参数，详情请点击左侧链接。
         # @type Encryption: :class:`Tencentcloud::Faceid.v20180301.models.Encryption`
+        # @param RuleId: 用于细分客户使用场景，申请开通服务后，可以在腾讯云慧眼人脸核身控制台（https://console.cloud.tencent.com/faceid） 自助接入里面创建，审核通过后即可调用。如有疑问，请添加腾讯云人脸核身小助手进行咨询。
+        # 示例值：1
+        # @type RuleId: String
 
-        attr_accessor :CompareLib, :IdCard, :Name, :ImageBase64, :Meta, :Extra, :UseCos, :Encryption
+        attr_accessor :CompareLib, :IdCard, :Name, :ImageBase64, :Meta, :Extra, :UseCos, :Encryption, :RuleId
 
-        def initialize(comparelib=nil, idcard=nil, name=nil, imagebase64=nil, meta=nil, extra=nil, usecos=nil, encryption=nil)
+        def initialize(comparelib=nil, idcard=nil, name=nil, imagebase64=nil, meta=nil, extra=nil, usecos=nil, encryption=nil, ruleid=nil)
           @CompareLib = comparelib
           @IdCard = idcard
           @Name = name
@@ -2038,6 +2103,7 @@ module TencentCloud
           @Extra = extra
           @UseCos = usecos
           @Encryption = encryption
+          @RuleId = ruleid
         end
 
         def deserialize(params)
@@ -2052,6 +2118,7 @@ module TencentCloud
             @Encryption = Encryption.new
             @Encryption.deserialize(params['Encryption'])
           end
+          @RuleId = params['RuleId']
         end
       end
 
@@ -2075,6 +2142,46 @@ module TencentCloud
         end
       end
 
+      # GetFaceidRiskInfoToken请求参数结构体
+      class GetFaceidRiskInfoTokenRequest < TencentCloud::Common::AbstractModel
+        # @param Meta: SDK中生成的Meta字符串
+        # @type Meta: String
+        # @param Extra: 透传参数 1000长度字符串
+        # @type Extra: String
+
+        attr_accessor :Meta, :Extra
+
+        def initialize(meta=nil, extra=nil)
+          @Meta = meta
+          @Extra = extra
+        end
+
+        def deserialize(params)
+          @Meta = params['Meta']
+          @Extra = params['Extra']
+        end
+      end
+
+      # GetFaceidRiskInfoToken返回参数结构体
+      class GetFaceidRiskInfoTokenResponse < TencentCloud::Common::AbstractModel
+        # @param FaceIdToken: 有效期 10分钟。只能完成1次核身。
+        # @type FaceIdToken: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :FaceIdToken, :RequestId
+
+        def initialize(faceidtoken=nil, requestid=nil)
+          @FaceIdToken = faceidtoken
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @FaceIdToken = params['FaceIdToken']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # GetLiveCode请求参数结构体
       class GetLiveCodeRequest < TencentCloud::Common::AbstractModel
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-faceid
 version: !ruby/object:Gem::Version
-  version: 3.0.789
+  version: 3.0.791
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-03-24 00:00:00.000000000 Z
+date: 2024-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common