纯服务端(API)接入

本文介绍身份三要素核验API接口。身份三要素指姓名身份证号人脸照片。接口会对比三者的真实性和一致性。

接口信息

重要

在使用本接口前,请确保已完整阅读接入流程,并开通服务。

  • 接口名: Id3MetaVerify

  • 接口说明:传入姓名、身份证号和人脸照片,通过权威源核验其真实性和一致性。

  • QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明

  • 服务地址(调用 API 时的 Endpoint):

    地域

    IPv4

    IPv6

    通用

    cloudauth.aliyuncs.com

    cloudauth-dualstack.aliyuncs.com

    北京

    cloudauth.cn-beijing.aliyuncs.com

    cloudauth-dualstack.cn-beijing.aliyuncs.com

    上海

    cloudauth.cn-shanghai.aliyuncs.com

    cloudauth-dualstack.cn-shanghai.aliyuncs.com

    说明
    • 服务地址可选择与业务服务器距离相近的 endpoint ,以降低延迟。

    • 也可以构建列表轮询使用,以提高可用性。

请求参数

入参图片格式要求

  • 图片格式:PNG、JPG、JPEG。

  • 认证主体的近期照片,人脸需要完整清晰无遮挡、表情自然且正对摄像头。

  • 照片清晰、曝光正常,脸部无过黑、过亮、光晕等情况、角度无太大偏差。

  • 分辨率不超过1920*1080(高*宽),至少为640*480,推荐短边缩放到720像素,压缩率大于0.9。照片高大于宽,如果传入的照片宽大于高,可能会影响检测效果。

  • 照片大小需要小于1 MB。

名称

类型

是否必选

描述

示例值

ParamType

String

加密方式:

  • normal:明文不加密

  • md5:MD5加密

重要
  • 所有参数的密文均取32位小写MD5字符串形式。

  • 不同MD5工具得出的密文可能不同,如果加密前接口可以调通但加密后不行,请尝试更换MD5工具。

normal

IdentifyNum

String

身份证号:

说明

仅支持二代居民身份证港澳台居住证的证件号码。

  • paramType 传 normal 时:输入身份证号明文。

  • paramType 传 md5 时:

    身份证号前6位(明文)+出生年月日(密文)+身份证号后4位(明文)。

  • 明文:429001********8211

  • 密文:

    42900132fa7bcd874161bea8ec8fd98f390ec98211

UserName

String

姓名:

  • paramType 传 normal 时:输入姓名明文。

  • paramType 传 md5 时:姓名第一个字密文+ 姓名其他部分明文。

  • 明文:张三

  • 密文:

    6499fc7409049355527ef6a2ba5706b8三​

FacetUrl

String

说明

FacetUrlFaceFileObject二选一。

人像面图片,地址需为公网可访问的HTTP、HTTPS链接。

https://www.aliyun.com/cert.jpeg

FaceFileObject

InputStream

人像面图片输入流。

-

Crop

String

允许裁剪人脸图片:

  • T:允许

  • F(默认):不允许

说明

若您请求的图片并非来自标准活体检测SDK采集,建议您允许裁剪人脸图片。

开启该功能后,将会对请求的图片先进行人脸裁剪与矫正,完成后会发起请求服务。

T

响应参数

名称

类型

描述

示例值

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF039795

Message

String

接口调用返回信息。

重要

此参数仅表示接口是否异常。

success

Code

String

返回码:200表示成功,其他均为失败。

重要
  • 此参数代表是否正确调用了接口,详细的返回码说明请参见服务端错误码

  • 业务核验结果请通过ResultObject中的字段查看。

200

ResultObject

BizCode

String

身份核验结果:

  • 1:校验⼀致

  • 2:校验不⼀致

  • 3:查⽆记录

1

FaceDetail

String

人像比对分值,取值范围:0~100,分值越大,相同人脸概率越高,默认阈值是90(即大于等于90,系统判定为相同人脸)。

{
  // 人脸和公安比对分数,阈值可参考下表详细说明。
  "verifyScore": 50.28
}

SDK调用示例

重要

集成前请确保您已完整阅读接入流程开通了服务获取AccessKey且正确配置环境变量

关于SDK示例和安装包获取:

  • 您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例,并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。

    说明

    注意选择所需的编程语言。

    image

  • 如果您有离线安装的需求,可以进入SDK安装页面选择需要语言SDK,并转到发布地址获取。

    image

  • OpenAPI平台可对接口进行在线调试,并获取SDK示例。

  • 代码示例工程各编程语言调用SDK的示例工程,可作为接入参考。