[按楼层查询] 获取指定楼层的所有房间列表

GET

/isim/room/list/floor/{floor_code}

获取指定楼层的所有房间信息

✅ 数据量最小：只返回单个楼层的房间列表，极小数据量
💡 使用场景：

用户选择楼层后，展示该楼层的所有房间

房间选择器的第三级

移动端分页加载

需要最快响应速度的场景

Args:
floor_code: 楼层代码（如：0101, 0102, 1101等）

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.loveac.linota.cn/isim/room/list/floor/' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功

application/json

Successful Response

Body

示例

{
    "success": true,
    "message": "string",
    "data": {
        "floor_code": "string",
        "floor_name": "string",
        "building_code": "string",
        "rooms": [
            {
                "code": "string",
                "name": "string"
            }
        ],
        "room_count": 0
    },
    "error": {
        "message": "string",
        "code": "string",
        "trace_id": "string"
    },
    "timestamp": "string"
}

🟠400请求有误

🟠401未认证

🟠403权限不足

🟠422无法处理的实体

🟠429请求过多

🔴500服务器内部错误

🔴502网关错误

🔴504网关超时

修改于 2025-11-05 11:01:53

[按楼栋查询] 获取指定楼栋的所有楼层和房间

[房间详情] 获取单个房间的完整层级信息