云服务 API 参考行业场景垂直行业解决方案校园办公座位管理座位管理查询座位列表

查询座位列表

更新时间：2023-06-21 07:13:00下载pdf

本文介绍查询座位列表的 API。

接口描述

查询座位列表。

接口地址

GET: /v1.0/iot-03/seats

请求参数

参数名	类型	参数位置	是否必填	说明
req	SeatQueryListReq	query	true	查询座位列表请求

req 说明

参数名	类型	是否必填	说明
area_id	String	false	座位所在区域 ID
seat_no	String	false	座位编号
type	String	false	座位类型
device_category	String	false	设备类型
status	String	false	座位状态
org_id	String	false	组织 ID
user_name	String	false	用户名称
page_size	Integer	false	页数
page_no	Integer	false	页码

返回示例

参数名	类型	说明
result	Page	分页座位结果

result 说明

参数名	类型	说明
has_more	Boolean	是否有更多数据
list	List	座位列表
total	Long	符合查询条件的数据总数

total 说明

参数名	类型	说明
id	String	座位 ID
seat_no	String	座位编号
area_id	String	区域
type	String	座位类型
device_categories	List	设备类型列表
remark	String	座位介绍
image_url	String	座位图片
status	String	座位状态，默认为 disable：停用； enable：启用；repairing：维修中
uid	String	用户 ID
user_name	String	用户名

list 说明

参数名	类型	说明
type	String	座位类型
status	String	座位状态 disable停用 -默认 enable启用 repairing维修中

请求示例

GET: /v1.0/iot-03/seats?area_id=1394999880337850xxx&seat_no=seat7-1&type=fixed&device_category=cz&user_name=useraccount&page_size=10&page_no=2

返回示例

{
    "result": {
        "list": [
            {
                "image_url": "www.tuya.com",
                "user_name": "useraccount",
                "seat_no": "seat7-1",
                "remark": "1",
                "area_id": "1394999880337850xxx",
                "device_categories": [
                    "cz",
                    "cz"
                ],
                "type": "fixed",
                "uid": "bsh1621233459390Hxxx",
                "id": "1396481709372866xxx",
                "status": "enable"
            }
        ],
        "total": 1,
        "has_more": false
    },
    "t": 1623052765596,
    "success": true
}

错误码

参考错误码。

上一篇查询单个座位信息

下一篇编辑座位状态