DescribeVerifyToken
发起认证请求,获取认证Token。该接口适用于使用SDK+服务端接入的认证方案
服务地址:
华东1 金融云
输入参数
只看必填
IdCardBackImageUrl身份证国徽面图片的HTTP或HTTPS链接
BizType使用实人认证服务的业务场景标识
FailedRedirectUrl验证失败跳转链接
FaceRetainedImageUrl人像留底照片的HTTP或HTTPS链接
CallbackSeed
IdCardFrontImageUrl身份证人像面图片的HTTP或HTTPS链接
UserId终端用户的ID
BizId认证ID
Name姓名
IdCardNumber身份证号
PassedRedirectUrl验证通过跳转链接
CallbackUrl回调Url
UserIp用户IP
UserPhoneNumber用户电话号码
UserRegistTime用户的注册时间
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接入准备:接入该 API 时,请确保已经完成相应的准备工作,具体请参见实人认证方案接入流程概述活体人脸验证方案(活体检测方案)接入流程概述

请求方法:HTTPS POST 和 GET

接口说明:每次开始认证前通过本接口获取认证 Token(VerifyToken),用来串联认证请求中的各个接口。

适用范围:该接口适用于无线 SDK 接入。

图片地址:需使用 HTTP 或 HTTPS 地址,公网可访问的 HTTP 或 HTTPS 地址。例如,http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg

图片限制:

  • 不支持本地图片的相对路径或绝对路径。
  • 单张图片大小请控制在 2 MB 内,避免算法拉取超时。
  • 图片中人脸区域的大小至少 64*64 像素(px)。
  • 单个请求的 Body 有 8 MB 的大小限制,请计算好请求中所有图片和其他信息的大小,不要超限。

请求参数

字段名称字段详情
IdCardBackImageUrlstring

身份证国徽面图片的 HTTP 或 HTTPS 链接。

示例值:http%3A%2F%2Fjiangsu.china.com.cn%2Fuploadfile%2F2015%2F0114%2F1421221304095989.jpg
BizTypestring

使用实人认证服务的业务场景标识。请先参见业务设置在控制台完成创建。

示例值:RPBasicTest
FailedRedirectUrlstring

验证失败跳转链接。

示例值:-
FaceRetainedImageUrlstring

人像留底照片的 HTTP 或 HTTPS 链接。

示例值:http%3A%2F%2Fjiangsu.china.com.cn%2Fuploadfile%2F2015%2F0114%2F1421221304095989.jpg
CallbackSeedstring
示例值:-
IdCardFrontImageUrlstring

身份证人像面图片的 HTTP 或 HTTPS 链接。

示例值:http%3A%2F%2Fjiangsu.china.com.cn%2Fuploadfile%2F2015%2F0114%2F1421221304095989.jpg
UserIdstring

终端用户的 ID,如终端用户的账号 ID。

示例值:user111
BizIdstring

认证 ID。标识一次认证任务的唯一 ID,不超过 64 字符。针对一次认证任务,系统支持无限次发起提交,直到最终认证通过,该任务完结。展开详情

示例值:39ecf51e-2f81-4dc5-90ee-ff86125be683
Namestring

姓名。

示例值:张三
IdCardNumberstring

身份证号。

示例值:330100xxxxxxxxxxxx
PassedRedirectUrlstring

验证通过跳转链接。

示例值:-
CallbackUrlstring

回调 Url。

示例值:-
UserIpstring

用户 IP。

示例值:192.168.***.***
UserPhoneNumberstring

用户电话号码。

示例值:187********
UserRegistTimeinteger<int64>

用户的注册时间。使用时间戳格式表达,单位:毫秒。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1577808000000

请求说明

根据选择的认证方案不同,所需传入的字段不太一样,具体可以参考下述表格中的说明。

认证方案Name 字段IdCardNumber 字段IdCardFrontImageUrl 字段IdCardBackImageUrl 字段FaceRetainedImageUrl 字段
RPBasic
RPManual
RPBioID
RPBioOnly可选传入可选传入
FVBioOnly
FDBioOnly

返回参数

字段名称字段详情
VerifyPageUrlstring

原 H5 认证方案入口链接,目前该方案已经下线,不支持新增接入。如果您有 H5 认证方案接入需求,建议您使用金融级实人认证的PC 或移动端 H5 网页接入方案

示例值:http%3A%2F%2Fjiangsu.china.com.cn%2Fuploadfile%2F2015%2F0114%2F1421221304095989.jpg
RequestIdstring

本次请求的 ID。

示例值:04F0F334-1335-436C-A1D7-6C044FE73368
VerifyTokenstring

该次认证的 Token,用来串联认证请求中的各个接口,在 30 分钟内有效。

示例值:c302c0797679457685410ee51a5ba375
OssUploadTokenobject

OSS 上传 Token 信息。

变更历史
暂无变更历史