有奖捉虫:云通信与企业服务文档专题,速来> HOT
注意
用户上传照片身份信息核验接口已升级为 照片人脸核身,本接口已下线不再维护,请谅解。

接口描述

接口请求域名:https://recognition.image.myqcloud.com/face/idcardcompare 本接口(idcardcompare)用于判断给定一张照片与身份证号和姓名对应的登记照的人脸相似度,即判断给定照片中的人与身份证上的人是否为同一人。
注意
本接口支持 HTTPS 协议,如果您现在使用的是 HTTP 协议,为了保障您的数据安全,请切换至 HTTPS。
如果开发者使用的是原域名(service.image.myqcloud.com),为获得更好的体验,请及时切换到以上域名。

请求头 header

所有请求都要求含有以下头部信息:
参数名
必选
描述
host
recognition.image.myqcloud.com
腾讯云人脸核身服务器域名。
content-length
包体总长度
每个请求的包体大小限制为6MB,不支持 .gif 类型的动图。
content-type
application/json 或 multipart/form-data
根据不同接口选择:
使用 application/json 格式,参数为 url,其值为图片的 url。
-
-
-
使用 multipart/form-data 格式,参数为 image,其值为图片的 base64。
-
-
-
authorization
鉴权签名
用于 鉴权 的签名。
注意
如选择 multipart/form-data,请使用 HTTP 框架/库推荐的方式设置请求的 content-type,不推荐直接调用 setheader 等方法设置,否则可能导致 boundary 缺失引起请求失败。

输入参数

使用 application/json 格式,参数选择 url ;使用 multipart/form-data 格式,参数选择 image。
参数名
必选
类型
说明
appid
String
接入项目的唯一标识,可在 账号信息云 API 密钥 中查看。
idcard_number
String
用户身份证号码。
idcard_name
String
用户身份证姓名 (中文,请使用 UTF-8 编码)。
image
Binary
image 和 url 只提供一个即可。
url
String
image 和 url 只提供一个即可;如果都提供,只使用 url。
session_id
String
相应请求的 session 标识符,可用于结果查询。

输出参数

字段
类型
说明
data.session_id
String
相应请求的 session 标识符。
data.similarity
Float
用户上传的图像与身份证登记照的人脸相似度,取值范围[0,100],推荐相似度大于75时可判断为同一人,可根据具体场景自行调整阈值。
code
Int
错误码。
message
String
错误描述。

示例

输入示例

使用 URL 的请求包

POST /face/idcardcompare HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: service.image.myqcloud.com
Content-Length: 187
Content-Type: application/json

{
"appid":"123456",
"idcard_number":"110110199909090909",
"idcard_name":"张三",
"url":"http://test-123456.image.myqcloud.com/test.jpg"
}

使用 image 的请求包

POST /face/idcardcompare HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: service.image.myqcloud.com
Content-Length: 735
Content-Type: multipart/form-data;boundary=--------------acebdf13572468

----------------acebdf13572468
Content-Disposition: form-data; name="appid";

123456
----------------acebdf13572468
Content-Disposition: form-data; name="idcard_number";

110110199909090909
----------------acebdf13572468
Content-Disposition: form-data; name="idcard_name";

张三
----------------acebdf13572468
Content-Disposition: form-data; name="image"; filename="test.jpg"
Content-Type: image/jpeg

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------acebdf13572468--

输出示例

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 204
Content-Type: application/json

{
"data":{
"similarity":100.0,
"session_id":"",
},
"code":0,
"message":"OK"
}

错误码

错误码
含义
3
错误的请求;其中 message:account abnormal,errorno is:2 为账号欠费停服
4
签名为空
5
签名串错误
6
签名中的 APPID/Bucket 与操作目标不匹配
9
签名过期
10
APPID 不存在
11
SecretId 不存在
12
APPID 和 SecretId 不匹配
13
重放攻击
14
签名校验失败
15
操作太频繁,触发频控
16
Bucket 不存在
21
无效参数
23
请求包体过大
24
无权限,未申请服务
107
鉴权服务不可用
108
鉴权服务不可用
213
内部错误
-4006
视频中自拍照特征提取失败
-4007
视频中自拍照之间对比失败
-4009
Card 照片提取特征失败
-4010
自拍照与 Card 照片相似度计算失败
-4011
照片解码失败
-4012
照片人脸检测失败
-4015
自拍照人脸检测失败
-4016
自拍照解码失败
-4017
Card 照片人脸检测失败
-4018
Card 照片解码失败
-5001
视频无效,上传文件不符合视频要求
-5002
唇语失败
-5005
自拍照解析照片不足,视频里检测到的人脸较少
-5007
视频没有声音
-5008
语音识别失败,视频里的人读错数字
-5009
视频人脸检测失败,没有嘴或者脸
-5010
唇动检测失败,视频里的人嘴巴未张开或者张开幅度小
-5011
活体检测失败(活体其他错误都归类到里面)
-5012
视频中噪声太大
-5013
视频里的声音太小
-5014
活体检测 level 参数无效
-5015
视频像素太低,最小 270 * 480
-5016
视频里的人不是活体(翻拍等攻击)
-5801
请求缺少身份证号码或身份证姓名
-5802
服务器内部错误,服务暂时不可用
-5803
身份证姓名与身份证号码不一致
-5804
身份证号码无效(因户口变动,极少数正常用户也会返回这个结果,此类用户无法使用本服务)
-5805
用户未输入图像或者 url 下载失败
-5809
用户身份证登记照无效(一般是派出所上传照片时出错,重新拍照片到身份证所属派出所提交可解决。
-5817
证件照质量较差,请到户籍所在地派出所进行核实
更多其他 API 错误码请查看 错误码说明