官方技术文档

Appearance

功能概述 ​

房产详情

接口访问 ​

接口地址 ​

property/house/detail

请求方式 Method ​

GET

Header - Authorization Type : Bearer Token ​

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

请求参数 ​

属性类型长度必填默认值说明
usersPropertyBuildingHouseIDint11true物业编号

返回值 ​

属性类型必填说明
usersPropertyBuildingHouseIDinttrue用户房产ID
propertyIDinttrue物业ID
usersPropertyIDinttrue用户物业ID
propertyBuildingIDinttrue物业楼栋ID
propertyBuildingUnitIDinttrue物业楼栋单元ID
propertyBuildingHouseIDinttrue物业楼栋房产ID
houseNumberstringtrue楼栋编号或名称描述
decorationSituationinttrue装修情况 0.未知 1.毛坯 2.简单装修 3.精装修 4.豪华装修
propertyRightinttrue产权 1.个人 2.他人 3.企业
coverImagestringtrue封面图
locationstringtrue所在地
longitudeinttrue经度
latitudeinttrue纬度
propertyTypeinttrue物业类型 1. 住宅 2.公寓 3.别墅 4.度假村 5.自建房
floorTypeinttrue楼板类型 1.塔楼 2.板式楼 3.塔板结合 4.其他'
groundParkinginttrue地面停车位数量
basementParkinginttrue地下室停车位数量
propertyFeeinttrue物业费 元/月（单位：分）
floorinttrue楼层
roomNumberinttrue房号（可以是整层）
certificateAreainttrue产证面积（单位：平方米）
actualAreainttrue实际面积（单位：平方米）
sharedAreainttrue公摊面积（单位：平方米）
gardenAreainttrue花园面积（单位：平方米）
floorHeightinttrue层高（单位：米）
totalRoomsinttrue房间数
totalLivingRoominttrue客厅数
totalKitcheninttrue厨房数
totalToiletinttrue厕所数
totalBalconyinttrue阳台数
priceinttrue房价（单位：分）
deal_priceinttrue成交价（单位：分）
rentinttrue租金（单位：分）
rentalRangestringtrue租金对应业务
depositTypeinttrue押金类型 1. 押一 2. 押二 3. 押三
rentTypeinttrue租金类型 1. 付一 2. 付二 3. 付3 4. 半年 5. 一年
contractPeriodinttrue合同签约 1. 短租 2. 月租 3. 季度租 4.半年 5. 一年 6. 两年 7. 三年 8. 更长
faceinttrue朝向 1.坐北朝南 2.坐南朝北 3.坐东朝西 4.坐西朝东 5.坐东南朝西北 6.坐东北朝西南 7.坐西北朝东南 8.坐西南朝东北
decorationSituationinttrue装修情况 0.未知 1.毛坯 2.简单装修 3.精装修 4.豪华装修
houseConfigstringtrue房屋配置json
constraintstringtrue房屋限制json
descstringtrue描述
dataStatusinttrue数据状态 1.已上传 2草稿箱 3.已审核 -1.已驳回
isOnlineinttrue是否上下架 0.否 1.是
propertyRightEntrustmentstringtrue产权委托书
propertyOwnershipCertificatestringtrue房产证地址
propertyMobilestringtrue权属联系方式
propertyCertificateTypeinttrue权属证件类型 1. 身份证 2. 护照 3. 军官证 4. 企业税号
propertyCertificatestringtrue权属证件内容
propertyPositiveCardImagestringtrue身份证正面照片地址
propertyObverseCardImagestringtrue身份证反面照片地址
roomModeinttrue房屋用途 0.未知 1.自用 2.出租 3.民宿
isFirstinttrue是否首次出租 0.否 1.是
isCollectioninttrue是否收藏 0.否 1.是
propertyUserNamestringtrue权属人名称
propertyCompanyNamestringtrue权属集团名称
rentTimeUnitinttrue租金时间单位 1.日 2.月 3.年
minimumLeaseTerminttrue最短租期
leaseTermUnitinttrue最短租期时间单位 1.日 2.月 3.年
rentalTypeinttrue出租类型 1.整租 2.合租
checkInTimedatetrue可入住时间(例如：2025-10-01)
filesarraytrue附件列表
imagearraytrue图片列表
voicearraytrue语音列表
createTimestringtrue创建时间

返回示例 ​

{
    "response": {
        "usersPropertyBuildingHouseID": 3,
        "propertyID": 1,
        "propertyBuildingID": 1,
        "propertyBuildingUnitID": 1,
        "propertyBuildingHouseID": 0,
        "houseNumber": "这是房子",
        "location": "",
        "longitude": "1",
        "latitude": "1",
        "propertyType": 1,
        "floorType": 1,
        "groundParking": 0,
        "basementParking": 0,
        "propertyFee": 0,
        "code": "0",
        "number": "自增业务编码",
        "floor": 0,
        "roomNumber": "",
        "certificateArea": "0.00",
        "actualArea": "0.00",
        "sharedArea": "0.00",
        "gardenArea": "0.00",
        "floorHeight": "0.00",
        "totalRooms": 0,
        "totalLivingRoom": 0,
        "totalKitchen": 0,
        "totalToilet": 0,
        "totalBalcony": 0,
        "rent": 1,
        "rentalRange": "",
        "depositType": 70,
        "rentType": 1,
        "contractPeriod": 0,
        "face": 0,
        "decorationSituation": 0,
        "houseConfig": "",
        "constraint": "",
        "desc": "",
        "propertyRight": 0,
        "propertyRightEntrustment": "",
        "propertyOwnershipCertificate": "",
        "propertyMobile": "",
        "propertyCertificateType": 0,
        "propertyCertificate": "",
        "propertyPositiveCardImage": "",
        "propertyObverseCardImage": "",
        "roomMode": 0,
        "dataLevel": 1,
        "dataStatus": 3,
        "isFirst": 0,
        "isCollection": 0,
        "file": [
            {
                "id": 1,
                "materialName": "test",
                "materialFileName": "test",
                "materialUrl": "https://baidu.com",
                "materialFileFormat": "size",
                "materialFileSize": 1234
            }
        ],
        "image": [
            {
                "id": 2,
                "materialName": "test",
                "materialFileName": "test",
                "materialUrl": "https://baidu.com",
                "materialFileFormat": "size",
                "materialFileSize": 1234
            }
        ],
        "voice": [
            {
                "id": 3,
                "materialName": "test",
                "materialFileName": "test",
                "materialUrl": "https://baidu.com",
                "materialFileFormat": "size",
                "materialFileSize": 1234
            }
        ],
        "createTime": "2025-05-06 04:48:26",
        "propertyUserName": ""
    },
    "requestId": "a374cc5c-a2d3-456a-a786-48cf7b04a6c4"
}