阿里云身份证识别接口API官方使用教程 https://help.aliyun.com/document_detail/30407.html
身份证识别
一、接口描述
1. 功能描述
识别二代居民身份证正反面的关键字段识别,包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限,识别准确率业内领先,稳定可靠。
2. 接口数据要求:
图片格式:jpg、jpeg、png、jfif
图片大小:小于1M
3. 接口使用:
根据阿里云身份证识别购买流程下单后,即可开始体验业内领先的人工智能API服务。公测期间服务具有调用量、QPS限制,如需更高性能的API服务,请联系客服扩容购买。
在获得使用权限后,您可使用已经封装好的SDK进行相应开发。
请求参数
(1)header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | String | 是 | image/jpg | 标准编码格式 |
Authorization | String | 是 | JDCLOUD2-HMAC-SHA256Credential=access... | 签名 |
(2)body请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
无 | binary | 是 | 无 | 图片内容,传入图片 |
返回说明
1、返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1001 | 参见错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remain | long | 1305 | 按天计算剩余调用次数 |
msg | string | 查询成功 | 参见错误码-系统级错误码 |
result | object | {...} | 查询结果 |
(2)业务返回参数
result参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | int | 0 | 参见错误码--业务级错误码 |
message | string | success | 状态码描述,参见错误码--业务级错误码 |
request_id | string | cb4f53b8c60e9589445cc4cd895cf5b6 | 为方便定位问题的32位uuid |
resultData | object | {...} | 返回识别结果 |
resultData参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
birthday | String | 1996-06-22 | 出生日期 |
address | String | 江苏省南通市开发区星海花园44幢505室 | 住址 |
gender | String | 女 | 性别 |
nationlity | String | 汉 | 名族 |
issuing_authority | String | 苏州市公安局姑苏分局 | 签发机关 |
valid_to | String | 2035-12-03 | 终止有效日期 |
valid_from | String | 2015-12-03 | 起始有效日期 |
name | String | 葛钰瑶 | 姓名 |
id | String | 32062319960622626X | 公民身份号码 |
2、返回示例
{
"code":1000,
"charge":false,
"remain":0,
"msg":"查询成功",
"result":{
"resultData": {
"birthday": "1984年10月19日",
"address": "成都市金牛区营通街6号1栋2单元1号",
"gender": "女",
"nationality": "汉",
"issuing_authority": "",
"valid_to": "",
"name": "周静林",
"valid_from": "",
"id": "51010519841019026X"
},
"message": "success",
"request_id": "329186449b547e2e19096b3dede18f55",
"code": 0
}
}