功能概述

租客租房列表

接口访问

接口地址

property/users/rental/list

请求方式 Method

GET

Header - Authorization Type : Bearer Token

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

请求参数

属性	类型	长度	必填	默认值	说明
size	int	11	false	20	每页数量
page	int	3	false	1	页码

返回值

属性	类型	必填	说明
rentalID	int	true	合同ID
status	int	true	状态
propertyID	int	true	物业ID
propertyBuildingHouseID	int	true	物业房产ID
usersPropertyID	int	true	用户物业ID
usersPropertyBuildingHouseID	int	true	用户房产ID
commencementDate	int	true	起租日
leaseTerm	int	true	租期
rent	int	true	租金
contractPeriod	int	true	合同租约
utilityBillDate	date	true	水电费缴纳日
rentalStatus	int	true	租赁合同状态 1. 业务创建 2. 租客确认 3. 业主确认并上传合同 4. 租客确认合同并创建订单（待支付） 5. 订单已支付（租约起点未到） 6. 租约进行中 7. 租期结束 -1. 租客拒绝 -2. 业主拒绝 -3. 订单取消 -4. 订单未支付自动取消 -5. 租客违约 -6. 业主违约 -7. 租客解约 -8. 业主解约 -9. 租客逾期业务终止
createTime	date	true	创建时间
modifyTime	date	true	修改时间
deleteTime	date	true	删除时间
houseName	string	true	房产名称
coverImage	string	true	房产封面图
totalRooms	int	true	房间数量
totalLivingRoom	int	true	客厅数量
totalKitchen	int	true	厨房数量
totalToilet	int	true	厕所数量
totalBalcony	int	true	阳台数量
certificateArea	int	true	方形产证面积
rentStatus	int	true	房产出租状态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	账单类型错误	检查参数是否正确
404	Fail	代码报错