查询预约记录

更新时间: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 }

错误码

参考 错误码