查询预约记录

更新时间：2023-06-21 07:12:54下载pdf

本文介绍查询预约记录的 API。

接口描述

支持通过用户 ID、用户名称、预约状态或预约列表页码等信息筛选预约记录。

接口地址

GET: /v1.0/iot-03/seat-reservations

请求参数

参数名	类型	参数位置	是否必填	说明
uid	String	query	false	用户 ID
user_name	String	query	false	用户名称
area_id	String	query	false	预约座位父 ID
seat_no	String	query	false	预约座位编号
start_time	Long	query	false	预约开始时间戳
end_time	Long	query	false	预约结束时间戳
page_size	Integer	query	false	数量
page_no	Integer	query	false	页码
status_list	String	query	false	预约状态，多个状态用逗号分隔reserved(已预约),signed_in(已签到),manually_cancel(手动取消)

返回参数

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

result 说明

参数名	类型	说明
has_more	Boolean	是否有更多数据
list	List	座位预约结果列表
total	Long	结果总数

list 说明

参数名	类型	说明
id	String	预约 ID
uid	String	预定用户 ID
user_name	String	用户名
seat_id	String	座位 ID
seat_no	String	座位编号
area_id	String	区域 ID
area_name	String	区域名称
status	String	预约状态
start_time	Long	预约开始时间
end_time	Long	预约结束时间

请求示例

GET: /v1.0/iot-03/seat-reservations?uid=bsh16214309853020xxx&user_name=chxxxin22&area_id=1394999846179438xxx&seat_no=ceshi12&status_list=signed_in&start_time=1621409209996&end_time=1621526399999&page_size=2&page_no=4

返回示例

{
    "result": {
        "list": [
            {
                "area_name": "ceshi12",
                "seat_id": "1394999880337850xxx",
                "user_name": "chxxxin22",
                "end_time": 1621526399999,
                "seat_no": "ceshi12",
                "area_id": "1394999846179438xxx",
                "start_time": 1621409209996,
                "uid": "bsh16214309853020xxx",
                "id": "1395214464898302xxx",
                "status": "signed_in"
            }
        ],
        "total": 1,
        "has_more": false
    },
    "t": 1623053363752,
    "success": true
}

错误码

参考错误码。

上一篇座位预约管理

下一篇取消座位预约