主题
房产证识别
接口描述
通过光学字符识别技术，对传入的房产证或不动产图片进行识别.
请求说明
HTTP 方法:
POST请求 URL：
/ai-cloud-face/api/ocr/houseHeader如下：
| 参数名称 | 值 |
|---|---|
| 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（建议保存） |
| -houseOcrRet | Object | - | 房产证OCR识别结果 |
| --holdername | OcrRet | - | 权利人 |
| --comsitBD1 | OcrRet | - | 共有情况 |
| --housenumber | OcrRet | - | 不动产单元号 |
| --locationBD | OcrRet | - | 坐落 |
| --righttype | OcrRet | - | 权利类型 |
| --rightnature | OcrRet | - | 权力性质 |
| --function | OcrRet | - | 用途 |
| --area1 | OcrRet | - | 面积 |
| --howspan | OcrRet | - | 使用期限 |
| --startday | OcrRet | - | 起始日期 |
| --endday | OcrRet | - | 结束日期 |
| --detail | OcrRet | - | 权利其他情况 |
| --comsit1 | OcrRet | - | 共有情况 |
| --realtime | OcrRet | - | 登记时间 |
| --houseowner1 | OcrRet | - | 房屋所有权人 |
| --comsitFC1 | OcrRet | - | 共有情况 |
| --loca1 | OcrRet | - | 房屋坐落 |
| --areareal | OcrRet | - | 建筑面积 |
| --areainnerreal | OcrRet | - | 套内建筑面积 |
| --houseway | OcrRet | - | 土地使用权取得方式 |
| --startyear | OcrRet | - | 土地使用年限起 |
| --endyear | OcrRet | - | 土地使用年限止 |
| --numberreal | OcrRet | - | 总层数 |
| --houseQ1 | OcrRet | - | 房屋性质 |
| --houseF1 | OcrRet | - | 规划用途 |
| --houseindex | 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坐标 |
返回示例：
{
"code": 0,
"data": {
"houseOcrRet": {
"certificateNameNumber": {
"key": "证件名称及号码",
"pos": {}
},
"certificateNumber": {
"key": "证书编号",
"pos": {}
},
"estateNumber": {
"key": "不动产权证书号",
"pos": {}
},
"estateType": {
"key": "产别",
"pos": {}
},
"estateUnitNumber": {
"key": "不动产单元号",
"pos": {}
},
"holdername": {
"key": "权利人",
"pos": {}
},
"houseCadastralNumber": {
"key": "房地籍号",
"pos": {}
},
"houseConstructionArea": {
"key": "面积",
"pos": {}
},
"houseFunction": {
"data": "成套住宅",
"key": "用途",
"pos": {
"p1": {
"x": 244,
"y": 574
},
"p2": {
"x": 358,
"y": 575
},
"p3": {
"x": 358,
"y": 612
},
"p4": {
"x": 244,
"y": 611
}
}
},
"houseLocation": {
"data": "管城回族区尚德路6号1号楼1单元11层1106号",
"key": "坐落",
"pos": {
"p1": {
"x": 233,
"y": 312
},
"p2": {
"x": 649,
"y": 317
},
"p3": {
"x": 649,
"y": 348
},
"p4": {
"x": 233,
"y": 343
}
}
},
"houseRightNumber": {
"data": "郑房权证字第1501097542号",
"key": "房屋所有权证号",
"pos": {
"p1": {
"x": 92,
"y": 171
},
"p2": {
"x": 238,
"y": 173
},
"p3": {
"x": 238,
"y": 209
},
"p4": {
"x": 92,
"y": 207
}
}
},
"houseStatus": {
"data": "",
"key": "房屋状况",
"pos": {}
},
"houseStructure": {
"key": "房屋结构",
"pos": {}
},
"houseType": {
"key": "房屋类型",
"pos": {}
},
"indoorConstructionArea": {
"key": "套内建筑面积",
"pos": {}
},
"landFunction": {
"key": "土地用途",
"pos": {}
},
"landNumber": {
"key": "地号",
"pos": {}
},
"landRightType": {
"key": "土地使用权类型",
"pos": {}
},
"locatedFloor": {
"data": "111",
"key": "所在层数",
"pos": {
"p1": {
"x": 233,
"y": 312
},
"p2": {
"x": 649,
"y": 317
},
"p3": {
"x": 649,
"y": 348
},
"p4": {
"x": 233,
"y": 343
}
}
},
"mutualOwnerStatus": {
"data": "单独所有",
"key": "共有情况",
"pos": {
"p1": {
"x": 256,
"y": 236
},
"p2": {
"x": 374,
"y": 237
},
"p3": {
"x": 374,
"y": 277
},
"p4": {
"x": 256,
"y": 276
}
}
},
"obligor": {
"key": "义务人",
"pos": {}
},
"otherRightsStatus": {
"key": "权利其他情况",
"pos": {}
},
"registrationDate": {
"data": "2015年04月17日",
"key": "登记时间",
"pos": {
"p1": {
"x": 244,
"y": 436
},
"p2": {
"x": 450,
"y": 438
},
"p3": {
"x": 450,
"y": 470
},
"p4": {
"x": 244,
"y": 468
}
}
},
"remarks": {
"key": "附记",
"pos": {}
},
"result": 0,
"rightProof": {
"key": "证明权利或事项",
"pos": {}
},
"rightnature": {
"key": "权力性质",
"pos": {}
},
"righttype": {
"key": "权利类型",
"pos": {}
},
"serviceLife": {
"key": "使用期限",
"pos": {}
},
"totalFloor": {
"key": "总层数",
"pos": {}
},
"usableArea": {
"key": "使用权面积",
"pos": {}
}
}
},
"message": "success",
"success": true
}错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 成功 |
| 50028100 | 否 | 否 | 图片不能为空 |
| 50028103 | 否 | 否 | 图片大小不能超过3M |
| 50028278 | 否 | 否 | 房产证识别异常 |
| 50028220 | 否 | 否 | 引擎检测异常 |
| 50028221 | 否 | 否 | 引擎检测异常 |
| 50028222 | 否 | 否 | 引擎检测异常 |