主题
不动产识别
接口描述
支持对传入的房产证、不动产证、不动产登记证明、渔船登记证图片，进行识别并转换为文字.
请求说明
HTTP 方法:
POST请求 URL：
/ai-cloud-face/v2/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识别结果 |
| --addressAndNo | OcrRet | - | 权属地及字第号 |
| --area1 | OcrRet | - | 面积 |
| --comsit1 | OcrRet | - | 共有情况 |
| --function | OcrRet | - | 用途 |
| --holdername | OcrRet | - | 权利人 |
| --housenumber | OcrRet | - | 不动产单元号 |
| --howspan | OcrRet | - | 使用期限 |
| --locationBD | OcrRet | - | 坐落 |
| --ownershipAddress | OcrRet | - | 权属地 |
| --registrationDate | OcrRet | - | 登记时间 |
| --rightNo | OcrRet | - | 字第号 |
| --rightnature | OcrRet | - | 权利性质 |
| --PS | OcrRet | - | 附记 |
| --righttype | OcrRet | - | 权利类型 |
| --landArea | OcrRet | - | 土地面积 |
| --landAreaShare | OcrRet | - | 分摊土地面积 |
| --buildingAreaShare | OcrRet | - | 分摊建筑面积 |
| --landAreaUnit | OcrRet | - | 土地面积单位 |
| --buildingAreaUnit | OcrRet | - | 建筑面积单位 |
| --landAreaShareUnit | OcrRet | - | 分摊土地面积单位 |
| --buildingAreaShareUnit | OcrRet | - | 分摊建筑面积单位 |
| --landFunction | OcrRet | - | 土地用途 |
| --planFunction | OcrRet | - | 规划用途 |
| --startday | OcrRet | - | 起始日期 |
| --endday | OcrRet | - | 结束日期 |
| --houseindex | OcrRet | - | 地号 |
不动产登记证明返回参数：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | int | 1-8 | 返回结果，0表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -houseOcrRet | Object | - | 不动产登记证明OCR识别结果 |
| --addressAndNo | OcrRet | - | 权属地及字第号 |
| --estateNumber | OcrRet | - | 不动产权证书号 |
| --rightproof | OcrRet | - | 证明权利或事项 |
| --holdername | OcrRet | - | 权利人 |
| --housenumber | OcrRet | - | 不动产单元号 |
| --obligor | OcrRet | - | 义务人 |
| --locationBD | OcrRet | - | 坐落 |
| --proof_detail | OcrRet | - | 其他 |
| --ownershipAddress | OcrRet | - | 权属地 |
| --registrationDate | OcrRet | - | 登记时间 |
| --rightNo | OcrRet | - | 字第号 |
| --PS | OcrRet | - | 附记 |
| --certificateNo | OcrRet | - | 编号 |
渔船登记证返回参数：
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | int | 1-8 | 返回结果，0表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -houseOcrRet | Object | - | 渔船登记证OCR识别结果 |
| --mortgageCertificateNumber | OcrRet | - | 抵押权登记证书编号 |
| --shipName | OcrRet | - | 船名 |
| --shipPort | OcrRet | - | 船籍港 |
| --vesselCode | OcrRet | - | 渔船编码 |
| --identifyCode | OcrRet | - | 识别码 |
| --shipOwnerName | OcrRet | - | 船舶所有人名称 |
| --share | OcrRet | - | 所占股份 |
| --shipOwnerID | OcrRet | - | 所有权人居民身份证号码 |
| --ownershipCertificateNumber | OcrRet | - | 所有权登记证书编号 |
| --shipType | OcrRet | - | 船舶种类 |
| --breedLicenseNumber | OcrRet | - | 养殖证号 |
| --shipMaterial | OcrRet | - | 船体材质 |
| --builtDate | OcrRet | - | 建造完工日期 |
| --mainScale | OcrRet | - | 主尺度 |
| --tonnage | OcrRet | - | 吨位 |
| --hostPower | OcrRet | - | 主机总功率 |
| --hostNumber | OcrRet | - | 主机数量 |
| --mortgageeName | OcrRet | - | 抵押权人姓名 |
| --mortgageeAddress | OcrRet | - | 抵押权人地址 |
| --mortgageeID | OcrRet | - | 抵押权人居民身份证号码 |
| --mortgageeContractNumber | OcrRet | - | 抵押/抵押权转移合同编号 |
| --expireDate | OcrRet | - | 终止日期 |
| --shipValue | OcrRet | - | 船舶价值 |
| --mortgageMoney | OcrRet | - | 抵押金额 |
| --ship_PS | OcrRet | - | 附注 |
| --administrationAuthority | OcrRet | - | 主管机关 |
| --certificateNo | OcrRet | - | 编号 |
| --issueDate | 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,
"success": true,
"message": "success",
"data": {
"houseOcrRet": {
"addressAndNo": {
"data": "浙(2018)金华市不动产权第30250564268号",
"key": "权属地及字第号",
"pos": {
"p1": {
"x": 0,
"y": 0
},
"p2": {
"x": 967,
"y": 0
},
"p3": {
"x": 967,
"y": 101
},
"p4": {
"x": 0,
"y": 101
}
}
},
"area1": {
"data": "共有宗地面积：986.11㎡/房屋建筑面积：108.89㎡",
"key": "面积",
"pos": {
"p1": {
"x": 320,
"y": 716
},
"p2": {
"x": 953,
"y": 716
},
"p3": {
"x": 953,
"y": 771
},
"p4": {
"x": 320,
"y": 771
}
}
},
"comsit1": {
"data": "单独所有",
"key": "共有情况",
"pos": {
"p1": {
"x": 300,
"y": 209
},
"p2": {
"x": 421,
"y": 209
},
"p3": {
"x": 421,
"y": 253
},
"p4": {
"x": 300,
"y": 253
}
}
},
"detail": {
"data": "套内建筑面积：85.85㎡,分摊建筑面积：23.04㎡房屋结构：钢筋混泥土结构房屋总层数：29层房屋竣工时间：2017年01月03日房屋所有权取得方式：购买登记时间：2018年03月05日",
"key": "权利其他状况",
"pos": {
"p1": {
"x": 321,
"y": 900
},
"p2": {
"x": 948,
"y": 900
},
"p3": {
"x": 948,
"y": 1138
},
"p4": {
"x": 321,
"y": 1138
}
}
},
"function": {
"data": "城镇住宅用地/成套住宅",
"key": "用途",
"pos": {
"p1": {
"x": 317,
"y": 645
},
"p2": {
"x": 607,
"y": 645
},
"p3": {
"x": 607,
"y": 685
},
"p4": {
"x": 317,
"y": 685
}
}
},
"holdername": {
"data": "余爽顺(511823198401107518)",
"key": "权利人",
"pos": {
"p1": {
"x": 295,
"y": 133
},
"p2": {
"x": 683,
"y": 133
},
"p3": {
"x": 683,
"y": 182
},
"p4": {
"x": 295,
"y": 182
}
}
},
"housenumber": {
"data": "440606006003Gb00667F00010188",
"key": "不动产单元号",
"pos": {
"p1": {
"x": 306,
"y": 379
},
"p2": {
"x": 789,
"y": 379
},
"p3": {
"x": 789,
"y": 419
},
"p4": {
"x": 306,
"y": 419
}
}
},
"howspan": {
"data": "建设用地使用权至2088年03月05日止",
"key": "使用期限",
"pos": {
"p1": {
"x": 321,
"y": 813
},
"p2": {
"x": 768,
"y": 813
},
"p3": {
"x": 768,
"y": 864
},
"p4": {
"x": 321,
"y": 864
}
}
},
"locationBD": {
"data": "浙江省金华市婺城区义乌街151号绿茵小区B栋301号",
"key": "坐落",
"pos": {
"p1": {
"x": 307,
"y": 290
},
"p2": {
"x": 912,
"y": 290
},
"p3": {
"x": 912,
"y": 338
},
"p4": {
"x": 307,
"y": 338
}
}
},
"ownershipAddress": {
"data": "浙(2018)金华市",
"key": "权属地",
"pos": {
"p1": {
"x": 0,
"y": 0
},
"p2": {
"x": 0,
"y": 0
},
"p3": {
"x": 0,
"y": 0
},
"p4": {
"x": 0,
"y": 0
}
}
},
"registrationDate": {
"data": "2018年03月05日",
"key": "登记时间",
"pos": {
"p1": {
"x": 0,
"y": 0
},
"p2": {
"x": 0,
"y": 0
},
"p3": {
"x": 0,
"y": 0
},
"p4": {
"x": 0,
"y": 0
}
}
},
"rightNo": {
"data": "30250564268",
"key": "字第号",
"pos": {
"p1": {
"x": 0,
"y": 0
},
"p2": {
"x": 0,
"y": 0
},
"p3": {
"x": 0,
"y": 0
},
"p4": {
"x": 0,
"y": 0
}
}
},
"rightnature": {
"data": "出让/市场化商品房",
"key": "权利性质",
"pos": {
"p1": {
"x": 316,
"y": 561
},
"p2": {
"x": 551,
"y": 561
},
"p3": {
"x": 551,
"y": 597
},
"p4": {
"x": 316,
"y": 597
}
}
},
"righttype": {
"data": "国有建设用地使用权/房屋所有权",
"key": "权利类型",
"pos": {
"p1": {
"x": 308,
"y": 472
},
"p2": {
"x": 707,
"y": 472
},
"p3": {
"x": 707,
"y": 511
},
"p4": {
"x": 308,
"y": 511
}
}
}
}
}
}错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 成功 |
| 50028100 | 否 | 否 | 图片不能为空 |
| 50028103 | 否 | 否 | 图片大小不能超过3M |
| 50028279 | 否 | 否 | 不动产证识别异常 |
| 50028223 | 否 | 否 | 引擎检测异常 |
| 50028224 | 否 | 否 | 引擎检测异常 |
| 50028225 | 否 | 否 | 引擎检测异常 |