找不到 API ? 点击 反馈吧
- 金融级实人认证
- 增强版实人认证
- 信息核验
- 车辆信息识别VehicleQuery
- 车辆要素核验VehicleMetaVerify
- 车辆投保日期查询VehicleInsureQuery
- 车辆要素核验增强版VehicleMetaVerifyV2
- 车五项信息识别Vehicle5ItemQuery
- 人脸Deepfake检测服务DeepfakeDetect
- 凭证核验CredentialVerify
- 银行卡二,三,四要素核验BankMetaVerify
- 手机号在网时长MobileOnlineTime
- 号码批量检测MobileDetect
- 手机号在网状态MobileOnlineStatus
- 手机号三要素简版接口Mobile3MetaSimpleVerify
- 手机号三要素简版——标准版Mobile3MetaSimpleStandardVerify
- 手机号三要素详版——标准版Mobile3MetaDetailStandardVerify
- 身份二要素核验接口Id2MetaVerify
- 二要素有效期核验Id2MetaPeriodVerify
- 身份二要素标准版核验接口Id2MetaStandardVerify
- 手机号三要素详版接口Mobile3MetaDetailVerify
- 实人认证(已停止售卖,文档停止更新)
- 其他
- 其它
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用户的注册时间
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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 信息。 |
变更历史
暂无变更历史