查询座位列表

更新时间：2023-06-15 05:47:23

本文介绍查询座位列表的 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
}

错误码

参考错误码。

上一篇查询单个座位信息

下一篇编辑座位状态