Skip to content

功能概述 ​

租客租房列表

接口访问 ​

接口地址 ​

property/users/rental/list

请求方式 Method ​

GET

Header - Authorization Type : Bearer Token ​

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

请求参数 ​

属性类型长度必填默认值说明
sizeint11false20每页数量
pageint3false1页码

返回值 ​

属性类型必填说明
rentalIDinttrue合同ID
statusinttrue状态
propertyIDinttrue物业ID
propertyBuildingHouseIDinttrue物业房产ID
usersPropertyIDinttrue用户物业ID
usersPropertyBuildingHouseIDinttrue用户房产ID
commencementDateinttrue起租日
leaseTerminttrue租期
rentinttrue租金
contractPeriodinttrue合同租约
utilityBillDatedatetrue水电费缴纳日
rentalStatusinttrue租赁合同状态 1. 业务创建 2. 租客确认 3. 业主确认并上传合同 4. 租客确认合同并创建订单(待支付) 5. 订单已支付(租约起点未到) 6. 租约进行中 7. 租期结束 -1. 租客拒绝 -2. 业主拒绝 -3. 订单取消 -4. 订单未支付自动取消 -5. 租客违约 -6. 业主违约 -7. 租客解约 -8. 业主解约 -9. 租客逾期业务终止
createTimedatetrue创建时间
modifyTimedatetrue修改时间
deleteTimedatetrue删除时间
houseNamestringtrue房产名称
coverImagestringtrue房产封面图
totalRoomsinttrue房间数量
totalLivingRoominttrue客厅数量
totalKitcheninttrue厨房数量
totalToiletinttrue厕所数量
totalBalconyinttrue阳台数量
certificateAreainttrue方形产证面积
rentStatusinttrue房产出租状态1.租房中,2.办理中,4.已退租,5.待入住

返回示例 ​

{
    "response": {
        "list": [
            {
                "rentalID": 19,
                "status": 0,
                "propertyID": 114,
                "propertyBuildingHouseID": 1726,
                "usersPropertyID": 143,
                "usersPropertyBuildingHouseID": 1741,
                "commencementDate": "2025-11-10",
                "leaseTerm": 2,
                "leaseTermType": 2,
                "rent": 2,
                "contractPeriod": 0,
                "utilityBillDate": null,
                "rentalStatus": 2,
                "createTime": "2025-11-10 15:44:08",
                "modifyTime": "2025-11-13 06:30:56",
                "deleteTime": null,
                "houseName": "测试房产",
                "coverImage": "",
                "totalRooms": 0,
                "totalLivingRoom": 0,
                "totalKitchen": 0,
                "totalToilet": 0,
                "totalBalcony": 0,
                "certificateArea": "0.00",
                "rentStatus": 2
            },
            {
                "rentalID": 27,
                "status": 0,
                "propertyID": 113,
                "propertyBuildingHouseID": 1690,
                "usersPropertyID": 141,
                "usersPropertyBuildingHouseID": 1705,
                "commencementDate": "2025-12-01",
                "leaseTerm": 1,
                "leaseTermType": 3,
                "rent": 2000,
                "contractPeriod": 0,
                "utilityBillDate": null,
                "rentalStatus": 5,
                "createTime": "2025-11-14 10:43:58",
                "modifyTime": "2025-11-14 13:50:17",
                "deleteTime": null,
                "houseName": "两房一厅,限时优惠出租",
                "coverImage": "https://file.juliyouren.com/6cc8d8f5eba0472c89ba16f07f4d5555.jpg?watermark/4/text/5bGF6YeM5pyJ5Lq6/fontsize/400/fill/Z3JheQ==/dissolve/50/rotate/30/uw/180/uh/180/resize/1",
                "totalRooms": 2,
                "totalLivingRoom": 1,
                "totalKitchen": 1,
                "totalToilet": 1,
                "totalBalcony": 1,
                "certificateArea": "80.00",
                "rentStatus": 2
            },
            {
                "rentalID": 32,
                "status": 0,
                "propertyID": 113,
                "propertyBuildingHouseID": 1691,
                "usersPropertyID": 141,
                "usersPropertyBuildingHouseID": 1706,
                "commencementDate": "2025-11-17",
                "leaseTerm": 6,
                "leaseTermType": 2,
                "rent": 3000,
                "contractPeriod": 0,
                "utilityBillDate": null,
                "rentalStatus": 5,
                "createTime": "2025-11-17 14:07:33",
                "modifyTime": "2025-11-17 14:09:46",
                "deleteTime": null,
                "houseName": "机关大厦两室一厅出租",
                "coverImage": "https://file.juliyouren.com/bd0e602316ed9b416347aae6ae0a41d4.jpg?watermark/4/text/5bGF6YeM5pyJ5Lq6/fontsize/400/fill/Z3JheQ==/dissolve/50/rotate/30/uw/180/uh/180/resize/1",
                "totalRooms": 2,
                "totalLivingRoom": 1,
                "totalKitchen": 1,
                "totalToilet": 1,
                "totalBalcony": 1,
                "certificateArea": "66.00",
                "rentStatus": 2
            }
        ],
        "pagination": {
            "total": 3,
            "page": 1,
            "pageSize": 20,
            "totalPage": 1
        }
    },
    "requestId": "2dcd1947-e0bc-4b6a-8dd2-9122bb2669c8"
}

错误码 ​

错误码说明解决方案
91021订单ID不能为空检查参数是否正确
91026账单类型错误检查参数是否正确
404Fail代码报错