Skip to content

功能概述

统一新增房产接口

接口访问

接口地址

property/unify/insert

请求方式 Method

POST

Header - Authorization Type : Bearer Token

属性类型长度必填默认值说明访问版本
tokenstring32true用户身份标识令牌-

请求参数

propertyInsert

属性类型长度必填默认值说明
propertyOwnershipCertificatestring11true房产证地址
namestring64true物业名称
coverImagestring64true封面图
propertyTypeint1true物业类型 1. 住宅 2.公寓 3.别墅 4.度假村 5.自建房
ownershipCategoryint1false权属类别 1.商品房 2.经济适用房 3.央产房 4.军产房 5.小产权房 6.自建房
timeForCompletionint11false竣工年份
termOfPropertyRightsint11false产权年限
propertyBuildingNumberint11false物业楼栋数量
totalHouseholdsint11false总户数
totalBuildingAreaint11false总建筑面积/平方米
minimumAreaint11false面积区间(最小/平方米)
maximumAreaint11false面积区间(最大/平方米)
plotRatioint11false容积率
greeningRateint11false绿化率
groundParkingint11false地面停车位数量
basementParkingint11false地下室停车位数量
groundParkingFeeint11false地面停车费 元/月(单位:分)
basementParkingFeeint11false地下停车费 元/月(单位:分)
vehicleFeeint11false车辆管理费 元/月(单位:分)
propertyFeeint11false物业费 元/月(单位:分)
propertyCompanystring256true物业公司
navigationAddressstring256false导航地址
longitudeint11false经度
latitudeint11false纬度
provinceint11false省份
cityint11false城市
regionint11false区域
townint11false乡镇
villageint11false
developersstring256false开发商
buildingTypeint1false建筑类型 1.高层 2.底层 3.平房
floorTypeint1false楼板类型 1.塔楼 2.板式楼 3.塔板结合 4.其他
businessDistrictstring256false1所属商圈
projectIssuesstring256false1周边配套信息
ownershipNatureint1false1权属人性质 1.个人 2.企业
ownershipMobilestring11false1权属联系方式
propertyCertificateTypeint1false1权属证件类型 1. 身份证 2. 护照 3. 军官证 4. 企业税号
ownershipCertificatestring256false1权属证件内容
clientUserNamestring256false1委托人名称
clientMobilestring11false1委托人联系方式
descstring256false1描述
ownershipUserNamestring256false1权属人名称,ownershipNature为1时必填
ownershipCompanyNamestring256false1权属集团名称,ownershipNature为2时必填
filesarrayfalse附件信息
imagearrayfalse图片信息
voicearrayfalse视频信息

buildingInsertList

属性类型长度必填默认值说明
propertyOwnershipCertificatestring11true房产证地址
namestring64true楼栋名称
coverImagestring255false封面图
occupiedAreaint1false占地面积(单位:平方米)
buildingAreaint11false建筑面积(单位:平方米)
floorsint11false楼层
floorHouseint11false每层规划多少户
floorPlanningstring11false楼层规划
liftNumberint11false电梯数
heightint11false楼高(单位:米)
floorHeightint11false层高(单位:米)
descstring11false描述
rentint11false租金(单位:分)
rentalRangestring11false租金包含业务
depositTypeint11false押金类型 1. 押一 2. 押二 3. 押三
rentTypeint11false租金类型 1. 付一 2. 付二 3. 付3 4. 半年 5. 一年
contractPeriodint11false合同签约 1. 短租 2. 月租 3. 季度租 4.半年 5. 一年 6. 两年 7. 三年 8. 更长
faceint11false朝向 1.坐北朝南 2.坐南朝北 3.坐东朝西 4.坐西朝东 5.坐东南朝西北 6.坐东北朝西南 7.坐西北朝东南 8.坐西南朝东北
decorationSituationint11false装修情况 0.未知 1.毛坯 2.简单装修 3.精装修 4.豪华装修
houseConfigstring256true房屋配置json
constraintstring256false房屋限制json
filesarrayfalse附件信息
imagearrayfalse图片信息
voicearrayfalse视频信息
unit_insert_listarrayfalse单元信息列表

unitInsertList

属性类型长度必填默认值说明
namestring64true单元名称
floorsint11false0楼层
floorHouseint11false1每层规划多少户
floorPlanningstring256false楼层规划
liftNumberint11false1电梯数
buildingNumberint11false1幢数
floorHeightfloat11false1层高(单位:米)
filesarrayfalse附件信息
imagearrayfalse图片信息
voicearrayfalse视频信息

files

属性类型长度必填默认值说明
materialNamestring256true文件名(自定义)
materialFileNamestring256true文件名(系统文件名)
materialUrlstring256true文件地址
materialFileFormatstring256true文件类型
materialFileSizestring256true文件大小

image

属性类型长度必填默认值说明
materialNamestring256true文件名(自定义)
materialFileNamestring256true文件名(系统文件名)
materialUrlstring256true文件地址
materialFileFormatstring256true文件类型
materialFileSizestring256true文件大小

voice

属性类型长度必填默认值说明
materialNamestring256true文件名(自定义)
materialFileNamestring256true文件名(系统文件名)
materialUrlstring256true文件地址
materialFileFormatstring256true文件类型
materialFileSizestring256true文件大小

请求示例

{
    "property_insert": {
        "propertyOwnershipCertificate": "",
        "city": 35,
        "name": "合并测试物业",
        "coverImage": "",
        "propertyType": 0,
        "ownershipCategory": "",
        "timeForCompletion": 0,
        "termOfPropertyRights": "",
        "propertyBuildingNumber": "",
        "totalHouseholds": "",
        "totalBuildingArea": "",
        "minimumArea": "",
        "maximumArea": 0,
        "plotRatio": 0,
        "greeningRate": 0,
        "groundParking": 0,
        "basementParking": 1,
        "groundParkingFee": "",
        "basementParkingFee": 70,
        "vehicleFee": 1,
        "propertyFee": 0,
        "propertyCompany": "",
        "navigationAddress": "",
        "longitude": "",
        "latitude": "",
        "province": 21,
        "region": "",
        "town": "",
        "village": "",
        "developers": "",
        "buildingType": "",
        "averagePrice": "",
        "averageRent": "",
        "floorType": "",
        "businessDistrict": "",
        "projectIssues": "",
        "ownershipNature": "",
        "ownershipMobile": "",
        "propertyCertificateType": "",
        "ownershipCertificate": "",
        "clientUserName": "",
        "clientMobile": "",
        "desc": ""
    },
    "building_insert_list": [
        {
            "propertyOwnershipCertificate": "",
            "name": "合并测试楼栋2",
            "occupiedArea": 0,
            "buildingArea": "",
            "coverImage": "",
            "floors": 0,
            "floorHouse": "",
            "liftNumber": "",
            "floorHeight": "",
            "height": "",
            "desc": 0,
            "rent": 0,
            "rentalRange": 0,
            "depositType": 0,
            "rentType": 1,
            "contractPeriod": "",
            "face": 70,
            "decorationSituation": 1,
            "houseConfig": 0,
            "constraint": "",
            "unit_insert_list": [
                {
                    "name": "合并测试单元2",
                    "floors": 3,
                    "floor_house": 2,
                    "floorPlanning": "都行2",
                    "liftNumber": 1,
                    "buildingNumber": 1,
                    "floorHeight": 3
                },
                {
                    "name": "合并测试单元3",
                    "floors": 3,
                    "floor_house": 2,
                    "floorPlanning": "都行2",
                    "liftNumber": 1,
                    "buildingNumber": 1,
                    "floorHeight": 3
                }
            ]
        },
        {
            "propertyOwnershipCertificate": "",
            "name": "合并测试楼栋3",
            "occupiedArea": 0,
            "buildingArea": "",
            "coverImage": "",
            "floors": 0,
            "floorHouse": "",
            "liftNumber": "",
            "floorHeight": "",
            "height": "",
            "desc": 0,
            "rent": 0,
            "rentalRange": 0,
            "depositType": 0,
            "rentType": 1,
            "contractPeriod": "",
            "face": 70,
            "decorationSituation": 1,
            "houseConfig": 0,
            "constraint": "",
            "unit_insert_list": []
        }
    ]
}

返回示例

{
    "response": {
        "Code": "200",
        "Message": "Success"
    },
    "requestId": "97223860-17fd-4741-84c5-ed157de85cf3"
}

错误码

错误码说明
10016用户手机号未绑定
40001没有操作权限
80013省市不能为空
80001物业信息不存在
80008房产对应物业等信息不能为空