身份证识别
服务返回信息的公共结构
参数名 | 类型 | 是否必有 | 说明 |
---|---|---|---|
signature | String | 是 | 我们采用的数字证书签名算法是:"RSA-SHA256" ,签名输出类型是:"base64" ,首先下载图普科技的公钥证书,然后按如下步骤认证:1、收到的JSON数据经过JSON.parse(),得到JSON对象,记为data; 2、data含两个字段:signature、json;signature是数字签名,json是真正的有效数据的字符串格式; 3、用signature对json进行签名认证,算法: RSA-SHA256 ,输出类型:base64 ,得到认证结果;4、认证通过后,对json进行JSON.parse(),得到JSON数据,详见"json"字段说明。 |
json | String | 是 | json 字段经过JSON.parse(json)后,得到具体的结果,含: message:与code相关的文本信息 timestamp:当前的服务器的Unix时间戳。 nonce:随机数。 |
json内容解析后的结构
参数名 | 类型 | 是否必有 | 说明 |
---|---|---|---|
code | Number | 是 | 请求的状态码,参考服务公共状态码解析 |
message | String | 是 | 请求的状态信息 |
timestamp | Number | 是 | 当前的服务器的Unix时间戳 |
nonce | Number | 是 | 随机数 |
[taskId] | Object | 是 | 识别任务的结果,不同识别任务会有特定的taskId和[taskId]信息结构 |
... | ... | 否 | 其它识别及请求响应结果信息 |
示例
{
"signature": "signature_from_tupu_service",
"json": "{\"code\":0,\"message\":\"success\",\"nonce\":\"0.5442530125172196\",\"timestamp\":1595318082309}"
}
任务结果信息
taskId
58a6765472afab41d9511da3
taskId参数
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
fileList | Array | 是 | 每张图片的识别结果 |
fileList参数
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
name | String | 是 | 如果上传的image参数是url,则该值是图片url;如果是以图片文件上传,则该值为文件名 |
objects | Array | 是 | 检测出来的所有物体 |
objects参数
参数名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
location | Array | 是 | 物体方框坐标[左上角坐标,右上角坐标,右下角坐标,左下角坐标] |
category | Number | 是 | 身份证信息类别 |
scores | Number | 是 | 身份证信息类别分数,准确度[0~1],分数越高,该类型越准确 |
字段信息对照表
category:
值 | 说明 |
---|---|
0 | 姓名 |
1 | 性别 |
2 | 民族 |
3 | 出生日期 |
4 | 住址 |
5 | 公民身份号码 |
6 | 签发机关 |
7 | 有效期限 |
返回的json示例
{
"58a6765472afab41d9511da3": {
"fileList": [
{
"name": "69.jpg",
"objects": [
{
"location": [
[
0.1666584814434119,
0.49657039130146347
],
[
0.5879490625019006,
0.49657039130146347
],
[
0.5879490625019006,
0.5524071807059837
],
[
0.1666584814434119,
0.5524071807059837
]
],
"category": 4,
"scores": 1,
"text": "福建省南安市官桥镇黄山村340号",
"degree": 359.73989787958794
},
{
"location": [
[
0.17333333333333334,
0.36625
],
[
0.3622222222222222,
0.36625
],
[
0.3622222222222222,
0.4
],
[
0.17333333333333334,
0.4
]
],
"category": 0,
"scores": 1,
"text": "郭佳",
"degree": 359
},
{
"location": [
[
0.29777777777777775,
0.60375
],
[
0.8933333333333333,
0.60375
],
[
0.8933333333333333,
0.6325
],
[
0.29777777777777775,
0.6325
]
],
"category": 5,
"scores": 1,
"text": "3203583200001291234",
"degree": 360
},
{
"location": [
[
0.1711111111111111,
0.4125
],
[
0.2511111111111111,
0.4125
],
[
0.2511111111111111,
0.44125
],
[
0.1711111111111111,
0.44125
]
],
"category": 1,
"scores": 1,
"text": "男",
"degree": 359
},
{
"location": [
[
0.3688888888888889,
0.4125
],
[
0.45555555555555555,
0.4125
],
[
0.45555555555555555,
0.44125
],
[
0.3688888888888889,
0.44125
]
],
"category": 2,
"scores": 1,
"text": "汉",
"degree": 359
},
{
"location": [
[
0.17157480259879954,
0.45590068773964343
],
[
0.46529265356968585,
0.45590068773964343
],
[
0.46529265356968585,
0.4800918657957196
],
[
0.17157480259879954,
0.4800918657957196
]
],
"category": 3,
"scores": 1,
"text": "2000-1-29",
"degree": 359.35617157790796
}
]
}
]
},
"code": 0,
"message": "success",
"nonce": "0.740538157274206",
"timestamp": 1574246346767
}