身份证识别
支持对二代居民身份证正反面所有8个字段进行结构化识别，包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限。
请求示例
HTTP 方法：`POST`
请求URL： [http://39.106.33.248:8088/idcard](http://172.16.10.32:8088/idcard)
Header如下：
|
**参数**
|
**值**
|
| --- | --- |
|
Content-Type
|
application/x-www-form-urlencoded
|
Body中放置请求参数，参数详情如下：
请求参数
|
**参数**
|
**是否必选**
|
**类型**
|
**可选值范围**
|
**说明**
|
| --- | --- | --- | --- | --- |
filePath 是 string 本地图片路径
side 是 string front/back -front：身份证含照片的一面
-back：身份证带国徽的一面
自动检测身份证正反面，如果传参指定方向与图片相反，支持正常识别，返回参数image_status字段为"reversed_side"
**示例：**
{
"filePath":"D:\\\\ideaProjects\\\\maomaoyu\\\\src\\\\main\\\\resources\\\\static\\\\身份证正面.jpg",
"side": "front"
}
[图片上传失败...(image-2afd1-1706673094840)]
**返回示例（身份证头像面）：**
{
"words_result": { 定位和识别结果数组
"姓名": {
"location": { 位置数组（坐标0点为左上角）
"top": 273,
"left": 655,
"width": 153,
"height": 54
},
"words": "蔡**"
},
"民族": {
"location": {
"top": 367,
"left": 874,
"width": 45,
"height": 46
},
"words": "汉"
},
"住址": {
"location": {
"top": 539,
"left": 655,
"width": 457,
"height": 110
},
"words": "江苏省海门市***"
},
"公民身份号码": {
"location": {
"top": 759,
"left": 831,
"width": 598,
"height": 61
},
"words": "320****874"
},
"出生": {
"location": {
"top": 450,
"left": 650,
"width": 365,
"height": 49
},
"words": "20000428"
},
"性别": {
"location": {
"top": 368,
"left": 654,
"width": 37,
"height": 47
},
"words": "男"
}
},
"words_result_num": 6, 识别结果数，表示words_result的元素个数
"idcard_number_type": 1,
用于校验身份证号码、性别、出生是否一致，输出结果及其对应关系如下： - 1****： 身份证正面所有字段全为空 0****： 身份证证号不合法，此情况下不返回身份证证号 1****： 身份证证号和性别、出生信息一致 2****： 身份证证号和性别、出生信息都不一致 3****： 身份证证号和出生信息不一致 4****： 身份证证号和性别信息不一致
"image_status": "normal",
normal-识别正常 reversed_side-身份证正反面颠倒 non_idcard-上传的图片中不包含身份证 blurred-身份证模糊 other_type_card-其他类型证照 over_exposure-身份证关键字段反光或过曝 over_dark-身份证欠曝（亮度过低） unknown-未知状态
"risk_type": "normal",
normal-正常身份证； copy-复印件； temporary-临时身份证； screen-翻拍； unknown-其他未知情况
"log_id": 1752224492569240506
}
银行卡识别
支持对主流银行卡的卡号、有效期、发卡行、卡片类型、持卡人、银行卡号位置 6 个关键字段进行结构化识别，识别准确率超过99%。同时支持返回银行卡号的字段位置坐标，及开启银行卡质量类型检测。
请求示例
HTTP 方法：`POST`
请求URL： [http://39.106.33.248:8088/bankCard](http://172.16.10.32:8088/bankCard)
Header如下：
|
**参数**
|
**值**
|
| --- | --- |
|
Content-Type
|
application/x-www-form-urlencoded
|
Body中放置请求参数，参数详情如下：
请求参数
|
**参数**
|
**是否必选**
|
**类型**
|
**可选值范围**
|
**说明**
|
| --- | --- | --- | --- | --- |
filePath 是 string 本地图片路径
**示例：**
{
"filePath": "D:\\ideaProjects\\maomaoyu\\src\\main\\resources\\static\\银行卡照片.jpg"
}
[图片上传失败...(image-6df597-1706673248103)]
{
"result": { 返回结果
"valid_date": "05/33", 有效期
"bank_card_number": "6214 ******* 3087", 银行卡卡号
"bank_name": "招商银行", 银行名，不能识别时为空
"bank_card_type": 1,
银行卡类型，0：不能识别; 1：借记卡; 2：贷记卡（原信用卡大部分为贷记卡）; 3：准贷记卡; 4：预付费卡
"card_quality": { 银行卡质量类型
"IsComplete_probability": 0.9961587787,
“是否边框/四角完整”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsClear_propobility 超过0.5时，对应 IsComplete 返回1，低于0.5，则返回0
"IsClear": 1, 质量类型，是否清晰
"IsClear_probability": 0.9202839732,
“是否清晰”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。默认阈值（仅为推荐值，建议按照实际业务场景，基于图片返回的具体概率值，自定义设置判断阈值）：当 IsClear_propobility 超过0.5时，对应 IsClear 返回1，低于0.5，则返回0
"IsComplete": 0 质量类型，是否边框/四角完整
},
"holder_name": "" 持卡人姓名，不能识别时为空
},
"direction": 0,
图像方向。 - - 1：未定义; - 0：正向; - 1：逆时针90度; - 2：逆时针180度; - 3：逆时针270度
"log_id": 1752229886647714844
}
