主题
结婚证或离婚证识别
接口描述
通过光学字符识别技术，对传入的结婚证或离婚证图片进行识别.
请求说明
HTTP 方法:
POST请求 URL：
/ai-cloud-face/ocr/marriageHeader如下：
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数，参数详情如下：
请求参数：
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| img | 是 | String | 1-3000k | 待处理图片(base64 编码)，原始图片大小需要小于 3M; |
| busFlowId | 否 | String | 0-64 | 业务流水号，业务系统唯一序列号（对账用，建议传入） |
请求示例：
{
"img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}返回说明
返回参数：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | int | 1-8 | 返回结果，0表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -busFlowId | String | 1-64 | 业务流水号，业务系统唯一序列号 |
| -flowId | String | 1-64 | 交易流水ID（建议保存） |
| -marriageLicenseRet | Object | - | 结婚证或离婚证OCR识别结果 |
| --type | OcrRet[] | - | 类型、结婚证或者是离婚证 |
| --name | OcrRet[] | - | 姓名 |
| --sex | OcrRet[] | - | 性别 |
| --birthday | OcrRet[] | - | 出生日期 |
| --certificateNo | OcrRet[] | - | 结婚证字号 |
| --holder | OcrRet[] | - | 持证人 |
| --idNo | OcrRet[] | - | 身份证号码 |
| --registerday | OcrRet[] | - | 注册日期 |
| --nation | OcrRet[] | - | 国籍 |
OcrRet对象：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| key | String | 1-64 | 属性key |
| data | String | 1-511 | 属性值 |
| pos | OcrPos | - | 识别坐标 |
OcrPos对象：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| p1 | Point | - | 坐标1 |
| p2 | Point | - | 坐标2 |
| p3 | Point | - | 坐标3 |
| p4 | Point | - | 坐标4 |
Point对象：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| x | int | 1-4 | x坐标 |
| y | int | 1-4 | y坐标 |
返回示例：
{
"marriageLicenseRet": {
"birthday": [{
"data": "1977-05-19",
"pos": {
"p1": {
"x": 347,
"y": 436
},
"p2": {
"x": 430,
"y": 435
},
"p3": {
"x": 430,
"y": 457
},
"p4": {
"x": 347,
"y": 458
}
}
},
{
"data": "1977-10-14",
"pos": {
"p1": {
"x": 342,
"y": 551
},
"p2": {
"x": 430,
"y": 551
},
"p3": {
"x": 430,
"y": 573
},
"p4": {
"x": 342,
"y": 573
}
}
}
],
"certificateNo": [{
"data": "J440106-2010-004961",
"pos": {
"p1": {
"x": 137,
"y": 223
},
"p2": {
"x": 293,
"y": 222
},
"p3": {
"x": 293,
"y": 244
},
"p4": {
"x": 137,
"y": 245
}
}
}],
"holder": [{
"data": "中国",
"pos": {
"p1": {
"x": 109,
"y": 85
},
"p2": {
"x": 145,
"y": 85
},
"p3": {
"x": 145,
"y": 107
},
"p4": {
"x": 109,
"y": 107
}
}
}],
"idNo": [{
"data": "429001900655190065",
"pos": {
"p1": {
"x": 140,
"y": 466
},
"p2": {
"x": 288,
"y": 464
},
"p3": {
"x": 288,
"y": 484
},
"p4": {
"x": 140,
"y": 486
}
}
},
{
"data": "2101014491X014491X",
"pos": {
"p1": {
"x": 141,
"y": 585
},
"p2": {
"x": 289,
"y": 585
},
"p3": {
"x": 289,
"y": 605
},
"p4": {
"x": 141,
"y": 605
}
}
}
],
"name": [{
"data": "中国",
"pos": {
"p1": {
"x": 88,
"y": 409
},
"p2": {
"x": 123,
"y": 407
},
"p3": {
"x": 124,
"y": 430
},
"p4": {
"x": 89,
"y": 432
}
}
},
{
"data": "中国",
"pos": {
"p1": {
"x": 91,
"y": 524
},
"p2": {
"x": 125,
"y": 524
},
"p3": {
"x": 125,
"y": 545
},
"p4": {
"x": 91,
"y": 545
}
}
}
],
"nation": [{
"data": "中国",
"pos": {
"p1": {
"x": 90,
"y": 439
},
"p2": {
"x": 124,
"y": 437
},
"p3": {
"x": 125,
"y": 458
},
"p4": {
"x": 91,
"y": 460
}
}
},
{
"data": "中国",
"pos": {
"p1": {
"x": 91,
"y": 551
},
"p2": {
"x": 125,
"y": 553
},
"p3": {
"x": 124,
"y": 575
},
"p4": {
"x": 90,
"y": 573
}
}
}
],
"registerday": [{
"data": "2010-10-16",
"pos": {
"p1": {
"x": 107,
"y": 157
},
"p2": {
"x": 192,
"y": 157
},
"p3": {
"x": 192,
"y": 176
},
"p4": {
"x": 107,
"y": 176
}
}
}],
"sex": [{
"data": "女",
"pos": {
"p1": {
"x": 318,
"y": 406
},
"p2": {
"x": 337,
"y": 405
},
"p3": {
"x": 338,
"y": 427
},
"p4": {
"x": 319,
"y": 428
}
}
},
{
"data": "男",
"pos": {
"p1": {
"x": 318,
"y": 523
},
"p2": {
"x": 334,
"y": 523
},
"p3": {
"x": 334,
"y": 544
},
"p4": {
"x": 318,
"y": 544
}
}
}
],
"type": [{
"data": "结婚证",
"pos": {
"p1": {
"x": 38,
"y": 219
},
"p2": {
"x": 122,
"y": 220
},
"p3": {
"x": 122,
"y": 244
},
"p4": {
"x": 38,
"y": 243
}
}
}]
}
}错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 成功 |
| 50028100 | 否 | 否 | 图片不能为空 |
| 50028103 | 否 | 否 | 图片大小不能超过3M |
| 50028283 | 否 | 否 | 结婚证/离婚证识别异常 |
| 50028235 | 否 | 否 | 引擎检测异常 |
| 50028236 | 否 | 否 | 引擎检测异常 |
| 50028237 | 否 | 否 | 引擎检测异常 |