在H5页面接入金融级实东说念主认证决策时白丝 捆绑，开导者需要在后端行状器集成SDK，以便调用InitFaceVerify接口得到用于浏览器进行实东说念主认证的认证麇集CertifyUrl。本文将详备先容行状端SDK的装配面目、所调接口的参数讲明以及现实调用接口示例讲明。
地域
行状地址
VPC地址
全局接入地址
华东2（上海）
IPv4：cloudauth.cn-shanghai.aliyuncs.com
cloudauth-vpc.cn-shanghai.aliyuncs.com
IPv4：cloudauth.aliyuncs.com
IPv6：cloudauth-dualstack.aliyuncs.com
IPv6：cloudauth-dualstack.aliyuncs.com
华北2（北京）
IPv4：cloudauth.cn-beijing.aliyuncs.com
cloudauth-vpc.cn-beijing.aliyuncs.com
IPv6：cloudauth-dualstack.cn-beijing.aliyuncs.com
行状端需要集成的两个接口InitFaceVerify-发起认证央求每次运行认证前通过调用本接口得到用于浏览器进行实东说念主认证的认证麇集CertifyUrl和每次认证的惟一CertifyId。
须将此接口的央求封装为运行认证的业务接口，供网页端调用。
LIVENESS（默许）：眨眼手脚活体检测。
PHOTINUS_LIVENESS（推选）：眨眼手脚活体+炫彩活体双重检测。
MULTI_ACTION：多手脚活体检测，眨眼+狂放摇头检测（限定就地）。
MOVE_ACTION：遐迩手脚+眨眼手脚活体检测。
MULTI_FAPTCHA：多手脚活体检测，眨眼+形迹判断（限定就地）。
PHOTINUS_LIVENESS
CertType
String
是
用户证件类型。相沿的证件类型，请参见使用截止。
不同证件类型，取值均为IDENTITY_CARD。
IDENTITY_CARD
CertName
String
是
您的终局用户的信得过姓名。
张三
CertNo
String
是
您的终局用户的证件号码。
330103xxxxxxxxxxxx
ReturnUrl
String
是
认证竣事后回跳页面的麇集地址。
https://www.aliyun.com
MetaInfo
String
是
MetaInfo环境参数。现实环境需要通过JS文献，调用函数getMetaInfo()得到，信服请参见认证触发页面（启动刷脸）。
{
"appVersion": "1"，
"bioMetaInfo": "4.1.0:1150****，0"，
"appName": "com.aliyun.antcloudauth"，
"deviceType": "ios"，
"osVersion": "iOS 10.3.2"，
"apdidToken": ""，
"deviceModel": "iPhone9，1"
}Mobile
String
否
您终局用户的手机号码。
130xxxxxxxx
Ip
String
否
您终局用户的IP。
47.100.XX.XX白丝 捆绑
UserId
String
否
您自界说的用户ID，请保捏惟一。
123456789
CallbackUrl
String
否
https://www.aliyun.com
CallbackToken
CallbackToken
否
安全Token，由您自行生成，用于防肖似、防删改校验。
要是确立了该值，会在回调地址中默契CallbackToken字段。
NMjvQanQgplBSaEI0sL86WnQplB
CertifyUrlType
String
否
Web SDK栽植类型。取值WEB大约H5。
WEB
CertifyUrlStyle
String
否
复返CertifyUrl类型，包括：
L：HTTPS，原始长链。
S：HTTP，短链。
L
AuthId
String
否
用户授权ID，最大长度为64位字符。
92d46b9e9e2d703f2897f350d5bd4149
EncryptType
String
否
加密类型。为空暗示不加密。
如开启加密传输，需传入加密算法。现在仅相沿SM2国密算法。
如需传入加密算法，需对CertName和CertNo进行加密，并传入加密后的密文。商酌参数加密的更多信息，网网网网色婷婷请参见参数加密讲明。
SM2
ProcedurePriority
String
否
挪动端H5面目认证出现WebRTC大约Webassembly不兼容时的左迁建立。
默许值为url。
keep：不相沿左迁，凯旋复返。
url：相沿左迁，复返认证URL，用户使用此URL掀开大约切换浏览器进行认证。
video：相沿左迁，使用系统相机录制一段3~5秒的眨眼视频进行认证。
url
FaceGuardOutput
String
否
东说念主脸保镖标签种类。
DeviceRisk：栽植风险标签。
DeviceRisk
RarelyCharacters
String
否
是否开启荒僻字时势：
Y：开启。
用户认证前会弹出信息输入框，需输入荒僻字姓名和身份证号码，欢跃公约后才能运行认证经过。
N：不开启（默许）。
Y
uiCustomUrl
String
否
UI建立文献URL。对于Web SDK自界说UI讲明，请参见Web SDK UI自界说建立讲明。
www.aliyundoc.com
VideoEvidence
String
否
是否开启视频存证。
true：开启
false：不开启（默许）
false
91707dc296d469ad38e4c5efa6a0f24b
ResultObject.CertifyUrl
String
Web浏览器进行实东说念主认证的URL，认证竣事后凭据入参ReturnUrl进行跳转。
****
DescribeFaceVerify-得到认证详备数据当您收到回调示知之后，不错在行状端通过该接口得到相应的认证景色和认证贵寓。
twitter 巨臀T
ResultObject.SubCode
String
认证效果描摹。信服请参见复返Code和Message。
200
ResultObject.IdentityInfo
String
认证的主体信息，一般的认证场景复返为空。
null
ResultObject.DeviceRisk
String
栽植风险标签。
VirtualBrowser
ResultObject.MaterialInfo
String
认证主体附件信息，主要为图片类材料。
示例见下文
ResultObject.UserInfo
String
纪录在荒僻字时势下用户输入的身份信息与对应编码。复返数据为JSON才气字符串，姓名中无荒僻字复返为空字符串。
name：指用户输入的姓名。
verifyName：指通过考证的最终姓名编码。举例荒僻字是通过转码认证通过：“王先生”，现实认证通过是“王先”。
number：指用户输入的证件号码。
{
"number":"610***********1110"，
"name":"王先生"，
"verifyName":"王先"
}复返Code和Message讲明，请参见复返Code和Message。
SDK调用示例阿里云提供了OpenAPI学派，不错使用网页或号令行面目事前考证接口，您不错通过底下的麇集参预调试：
InitFaceVerify调试进口
DescribeFaceVerify调试进口
SDK集成Java话语为例，条件JDK 1.8及以上版块。
在pom.xml中添加如下依赖，即可在Maven工程中使用SDK。
Java SDK依赖。以下依赖版块仅供参考，忽视在现实建立时得到最新依赖版块。
<dependency> <groupId>com.aliyun</groupId> <artifactId>cloudauth20190307</artifactId> <version>2.7.2</version> </dependency>
身份考证依赖。请检察ChangeLog.txt得到整个已发布的版块列表（忽视使用最新的版块）。
<dependency> <groupId>com.aliyun</groupId> <artifactId>credentials-java</artifactId> <version>LATEST</version> </dependency>
接口调用示例。