tencentcloud-sdk-faceid 3.0.788 → 3.0.790

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ef4ace3511f590fa8cadbb9f56cc664989f8c729
-  data.tar.gz: 43db31b26c6a5f099d34476ecc066c844bac192e
+  metadata.gz: 9b04f61d0be80afbbf639690012f32701d416ee4
+  data.tar.gz: 3b164b73ca769b0da3f76b7c812e55b64bc87017
 SHA512:
-  metadata.gz: 339e6d893e17bf1c29997386b6ed90b240c5dc26ff697099b350fa99f349208e57be434d562333572b518d29611e0a642c0f43557dbacc4fb4255737f100b3ae
-  data.tar.gz: 81c64809ec597db09d6e8e4d7e03f5c6a9910c2ecbd6e8b9e513df152b747d204191d8a246315a4549fb69b920648d1864bea6b5d4bb99b1b36a05696afc8e6a
+  metadata.gz: ddbcf60015bb0830189ea040ecead3d93510409afdd034bb712d723cf4d3ba1603229173dd784b1132d6381e472756b2d68deb3fa602515140b4872712845860
+  data.tar.gz: 2d4e8d3285489521431333a6a21ddc5448d685ee74e037aa37905bc76b72b8447952e0e3904c2e56ce659a71fd0ba8e5979ca0bd0260208a0c5a5ac2c150bc89

data/lib/VERSION

@@ -1 +1 @@
-3.0.788
+3.0.790

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

@@ -1798,10 +1798,12 @@ module TencentCloud
         # @type IntentionRecognition: Boolean
         # @param IsSupportHMTResidentPermitOCR: 是否支持港澳台居住证识别
         # @type IsSupportHMTResidentPermitOCR: Boolean
+        # @param MouthOpenRecognition: 用户语音回答过程中是否开启张嘴识别检测，默认不开启，仅在意愿核身问答模式中使用。
+        # @type MouthOpenRecognition: Boolean
 
-        attr_accessor :InputType, :UseIntentionVerify, :IntentionMode, :IntentionVerifyText, :IntentionQuestions, :IntentionActions, :IntentionRecognition, :IsSupportHMTResidentPermitOCR
+        attr_accessor :InputType, :UseIntentionVerify, :IntentionMode, :IntentionVerifyText, :IntentionQuestions, :IntentionActions, :IntentionRecognition, :IsSupportHMTResidentPermitOCR, :MouthOpenRecognition
 
-        def initialize(inputtype=nil, useintentionverify=nil, intentionmode=nil, intentionverifytext=nil, intentionquestions=nil, intentionactions=nil, intentionrecognition=nil, issupporthmtresidentpermitocr=nil)
+        def initialize(inputtype=nil, useintentionverify=nil, intentionmode=nil, intentionverifytext=nil, intentionquestions=nil, intentionactions=nil, intentionrecognition=nil, issupporthmtresidentpermitocr=nil, mouthopenrecognition=nil)
           @InputType = inputtype
           @UseIntentionVerify = useintentionverify
           @IntentionMode = intentionmode
@@ -1810,6 +1812,7 @@ module TencentCloud
           @IntentionActions = intentionactions
           @IntentionRecognition = intentionrecognition
           @IsSupportHMTResidentPermitOCR = issupporthmtresidentpermitocr
+          @MouthOpenRecognition = mouthopenrecognition
         end
 
         def deserialize(params)
@@ -1835,6 +1838,7 @@ module TencentCloud
           end
           @IntentionRecognition = params['IntentionRecognition']
           @IsSupportHMTResidentPermitOCR = params['IsSupportHMTResidentPermitOCR']
+          @MouthOpenRecognition = params['MouthOpenRecognition']
         end
       end
 
@@ -2002,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)
@@ -2071,6 +2137,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
 
@@ -2584,6 +2690,7 @@ module TencentCloud
         # -201: "人脸比对相似度低"
         # -202: "人脸比对失败"
         # -301: "意愿核验不通过"
+        # -302: "用户回答阶段未检测到张嘴动作"
         # -800: "前端不兼容错误"
         # -801: "用户未授权摄像头和麦克风权限"
         # -802: "核验流程异常中断，请勿切屏或进行其他操作"

metadata

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