身份证信息认证

最近更新时间:2018-06-11 12:03:41

人脸核身已全面升级,您可以到人脸核身官网申请新版本的服务。

接口概述

服务简介

本接口主要用于认证用户提供的身份信息是否正确。

开发者使用功能之前,需要先注册腾讯云账号,并创建 bucket,添加密钥。

计费说明

本接口按实际使用量计费,具体定价请查看 计费说明

url 说明

支持 http 和 https 两种协议:

http://recognition.image.myqcloud.com/auth/idcard

https://recognition.image.myqcloud.com/auth/idcard

请求方式

请求头 header

所有请求都要求含有以下头部信息:

参数名 必选 描述
host recognition.image.myqcloud.com 腾讯云信息认证服务器域名
content-length 包体总长度 整个请求包体内容的总长度,单位:字节(Byte)
content-type application/json 或 multipart/form-data 根据不同接口选择:
1. 使用 application/json 格式,参数为 url,其值为图片的 url ;
2. 使用 multipart/form-data 格式,参数为 image,其值为图片的 base64 。
authorization 鉴权签名 多次有效签名,用于鉴权,生成方式见 鉴权签名方法

注意:
如选择 multipart/form-data,请使用 http 框架/库推荐的方式设置请求的 contenttype,不推荐直接调用 setheader 等方法设置,否则可能导致 boundary 缺失引起请求失败。

请求参数

使用 application/json格式:

参数名 必选 类型 参数说明
appid string 项目 ID
idcard_number string 身份证号
idcard_name string 姓名(UTF-8 编码)

返回内容

字段 类型 说明
data.session_id string 相应请求的 session 标识符
code int 返回码
message string 返回错误消息

实际示例

请求示例

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

{
  "appid":"123456",
  "bucket":"test",
  "idcard_number":"110101xxxxxxxxxxxx",
  "idcard_name":"张三"
}

返回示例

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

{
  "data":{
    "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 没有权限
25 您购买的资源已用完
107 鉴权服务不可用
108 鉴权服务不可用
213 内部错误
-5803 身份证号码与姓名不匹配
-5804 身份证号码无效
-5806 身份证号码或者姓名格式错误
-5807 查询身份证信息失败