addSpaceAppoint 预约

对座位进行预约

请求 URL

POST https://aiot.fzu.edu.cn/api/ibs/spaceAppoint/app/addSpaceAppoint

请求头

参数名类型必填描述
tokenstring用户认证令牌

请求参数

参数名类型必填描述备注
spaceIdstring座位编号示例:422
beginTimestring预约开始时间格式:HH:mm
endTimestring预约结束时间格式:HH:mm
datestring预约日期格式:YYYY-MM-DD

Warning:

spaceId 是不同于我们看到的编号,是另一个号码,我们熟知的编号一般是 spaceName,对照表放在 这里,你也可以在 这里 找到一个转换工具

Note:

  1. 预约时间不得超过 4.5 小时,不同于 APP 中的 4 小时限制
  2. 开始时间和结束时间可以不在 8:00-22:30 之间

响应参数

参数名类型描述备注
dataobject数据对象通常为null
dataListobject数据列表通常为null
pageIndexint页码通常为null
pageSizeint每页大小通常为null
currentPageint当前页码通常为null
totalint总记录数通常为null
codestring响应代码
msgstring响应消息
otherDataobject其他数据通常为null
  • code0 时表示成功,1001-1 时表示失败。
  • msg 为响应消息。
    • 该座位已被预约:所选空间已被预约,请重新选择!
    • 预约时间大于 4.5 小时:预约时间不合理,请重新选择!
    • 结束时间小于开始时间:系统异常
    • 时间不是整点或半整点:时间格式不正确
    • 错误的座位编号:预约空间不存在!
    • 预约成功:成功

请求示例

{
    "spaceId": "200",
    "beginTime": "08:00",
    "endTime": "09:00",
    "date": "2021-09-01"
}

响应示例

{
    "data": null,
    "dataList": null,
    "pageIndex": null,
    "pageSize": null,
    "currentPage": null,
    "total": null,
    "code": "0",
    "msg": "预约成功",
    "otherData": null
}

代码示例

import requests

url = "https://aiot.fzu.edu.cn/api/ibs/spaceAppoint/app/addSpaceAppoint"

payload = {
    "spaceId": "200",
    "beginTime": "08:00",
    "endTime": "09:00",
    "date": "2021-09-01"
}

headers = {
    "token": "your token"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())