会议预约管理
API的文档位于 https://dev.izhiju.cn/mapi/doc/
为了通过API访问REST资源,需要一个身份验证令牌。可以通过执行身份验证API轻松获取令牌。有几种方法可以测试API,一种简单的方法是使用Swagger UI:
1. 用户登录接口
- 请求方法: POST
- 请求URL:https://dev.izhiju.cn/mapi/v1/authentication/user
- 请求头参数:accept: application/json Content-Type: application/json
- 请求体(json格式):
{
"username": "string",
"password": "string"
}
- 在线测试 可打开URL https://dev.izhiju.cn/mapi/doc/#!/Authentication/authenticationUser
- 点击try it out
- 输入参数: “username”: 账号, “password”: 密码 。
- 然后点击 excute 请求成功:
- 系统将返回JSON对象
- 复制字段tokenId的值(tokenId 有效时间三十分钟)
- 将值粘贴到网页顶部标有api_key的框中即可
请求失败:
- 系统将返回 ‘401’错误信息如下
- INVALID_LOGIN_CREDENTIALS 密码错误
- UNKNOWN_LOGIN_CREDENTIAL 账号没找到
- LOCKED_LOGIN_CREDENTIAL 账号锁定
- DISABLED_LOGIN_CREDENTIAL 账号禁用
- EXPIRED_LOGIN_CREDENTIALS 密码过期
Swagger会自动将身份验证令牌添加到使用Swagger UI完成的每个后续请求中。您已准备好尝试执行记录的API。
- curl 命令样例
- curl -X POST “https://dev.izhiju.cn/mapi/v1/authentication/user" -H “accept: application/json” -H “Content-Type: application/json” -d “{ "username": "admin", "password": "password"}”
2. 创建会议接口
- 请求方法: POST
- 请求URL:https://dev.izhiju.cn/mapi/v1/AQ/meetings
- 请求头参数:accept: application/json Content-Type: application/json Authorization: 登陆获取到的tokenid
- 请求体样例(json格式):
{
"scopeId": "AQ",//固定为 AQ
"name": "apitest会议1", //会议名称
"meetingContent": "内容1",//会议内容
"meetingTheme": "主题1", //会议主题
"roomId": "FVgM2cZFam8", //会议室id
"reservedDate": "2020-05-28", //预约日期
"startTime": 676,//会议开始时间 24小时中的分钟数
"endTime": 690,//会议结束时间 24小时中的分钟数
}
- 返回结果:
{
"type": "meeting",
"id": "KM4r_5mFPLQ",
"scopeId": "AQ",
"createdOn": "2020-05-27T09:56:37.000Z",
"createdBy": "AQ",
"modifiedOn": "2020-05-27T09:56:37.000Z",
"modifiedBy": "AQ",
"optlock": 1,
"name": "apitest会议1",
"meetingContent": "内容1",
"meetingTheme": "主题1",
"meetingType": 0,
"reservedDate": "2020-05-28",
"roomId": "FVgM2cZFam8",
"startTime": 676,
"endTime": 690
}
- 在线测试 url : https://dev.izhiju.cn/mapi/doc/#/ZJ-Meeting%20Room/createRoom
- curl 命令样例
- curl -X POST “https://dev.izhiju.cn/mapi/v1/AQ/meetings" -H “accept: application/json” -H “Authorization: eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL2Rldi5pemhpanUuY24vYXBpIiwiaWF0IjoxNTkwNTcyMTE3LCJleHAiOjE1OTA1OTAxMTcsInN1YiI6IkFRIiwic0lkIjoiQVEifQ.GmPLjIXqyZTBy_5r9avRCrnciKjzEGxFxRXnNMxxYgzVxJCp6Ry8Yq2Z-YTdNIxGFu-EvUsvhhiOnQycjMA0mU2lb_WOFga2IPwk6X_Ei6KfjHvJVaa-BntzcFiu6BLibVHW8yFy_-fOxJQY7lex1WO6cIPkUb1lFn9JmHLbxgW5MsNmeVqQBkJaks9N7tWOFo9sSSM6wXL-WShdK2Tvqwp_NpXqjjN4Llf4ouhapo_GhbQcguRHsGWIrzbg87upo8us26hmdtLV6MQlSB6UGYk8FomYXOJeEIRdriX2AiTocY5l66oMReX9SNq69Tar8KHMQOEPAqqVS9e6Q_Z5P6u3jkDx84slm1KEWSxJk31POW7BuFeuWQxjzt_D8Xr6E6Qb5tpAF0fiU22zJFRbfhGupF-Gno4bUNWZ7HvhOIzKz1oYUesAhaIe5UF6d8SZRaAijftWZiKl1yrht2Fg__FYM0ufv5k_Hd3i4Pzw-59avUEoXvWeYhAn462ZK_t4WIzU_QvJesViWpYLLl-0JKOxer-An80wuihgtBoeD3m3LeO9KJNviC_TxW9qprkxnL3aspcky4BJxv4qwsw5xVa6UKrE_ELh6smDNO_7uWlNJcTdX6O1-YpmoPNKZi1O563mxO24ZIAF1sVs-QgEoLloV5z-6XhxVzY2UG5ys4g” -H “Content-Type: application/json;charset=UTF-8” -d “{ "scopeId": "AQ", "name": "apitest会议1", "endTime": 690, "meetingContent": "内容1", "meetingTheme": "主题1", "meetingType": 0, "reservedDate": "2020-05-28", "roomId": "FVgM2cZFam8", "startTime": 676 }”
3. 更新会议接口
- 请求方法: PUT
- 请求URL:https://dev.izhiju.cn/mapi/v1/AQ/meetings/{meetingid} - 如:https://dev.izhiju.cn/mapi/v1/AQ/meetings/M4r_5mFPLQ
- 请求头参数:accept: application/json Content-Type: application/json Authorization: 登陆获取到的tokenid
- 请求体(json格式):
{
"id": "KM4r_5mFPLQ",
"scopeId": "AQ",
"name": "apitest会议11",
"meetingContent": "内容1",
"meetingTheme": "主题11",
"meetingType": 0,
"reservedDate": "2020-05-28",
"roomId": "FVgM2cZFam8",
"startTime": 676,
"endTime": 690
}
- 返回结果:
{
"type": "meeting",
"id": "KM4r_5mFPLQ",
"scopeId": "AQ",
"createdOn": "2020-05-27T09:56:37.000Z",
"createdBy": "AQ",
"modifiedOn": "2020-05-27T12:06:34.000Z",
"modifiedBy": "AQ",
"optlock": 3,
"name": "apitest会议1",
"endTime": 690,
"meetingContent": "内容1",
"meetingTheme": "主题11",
"meetingType": 0,
"reservedDate": "2020-05-28",
"roomId": "FVgM2cZFam8",
"startTime": 676
}
- 在线测试url: https://dev.izhiju.cn/mapi/doc/#/ZJ-Meeting%20Room/update%20Room
- curl 命令样例
- curl -X PUT “https://dev.izhiju.cn/mapi/v1/AQ/meetings/KM4r_5mFPLQ" -H “accept: application/json” -H “Authorization: eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL2Rldi5pemhpanUuY24vYXBpIiwiaWF0IjoxNTkwNTcyMTE3LCJleHAiOjE1OTA1OTAxMTcsInN1YiI6IkFRIiwic0lkIjoiQVEifQ.GmPLjIXqyZTBy_5r9avRCrnciKjzEGxFxRXnNMxxYgzVxJCp6Ry8Yq2Z-YTdNIxGFu-EvUsvhhiOnQycjMA0mU2lb_WOFga2IPwk6X_Ei6KfjHvJVaa-BntzcFiu6BLibVHW8yFy_-fOxJQY7lex1WO6cIPkUb1lFn9JmHLbxgW5MsNmeVqQBkJaks9N7tWOFo9sSSM6wXL-WShdK2Tvqwp_NpXqjjN4Llf4ouhapo_GhbQcguRHsGWIrzbg87upo8us26hmdtLV6MQlSB6UGYk8FomYXOJeEIRdriX2AiTocY5l66oMReX9SNq69Tar8KHMQOEPAqqVS9e6Q_Z5P6u3jkDx84slm1KEWSxJk31POW7BuFeuWQxjzt_D8Xr6E6Qb5tpAF0fiU22zJFRbfhGupF-Gno4bUNWZ7HvhOIzKz1oYUesAhaIe5UF6d8SZRaAijftWZiKl1yrht2Fg__FYM0ufv5k_Hd3i4Pzw-59avUEoXvWeYhAn462ZK_t4WIzU_QvJesViWpYLLl-0JKOxer-An80wuihgtBoeD3m3LeO9KJNviC_TxW9qprkxnL3aspcky4BJxv4qwsw5xVa6UKrE_ELh6smDNO_7uWlNJcTdX6O1-YpmoPNKZi1O563mxO24ZIAF1sVs-QgEoLloV5z-6XhxVzY2UG5ys4g” -H “Content-Type: application/json;charset=UTF-8” -d “{ "id": "KM4r_5mFPLQ", "scopeId": "AQ", "name": "apitest会议11", "endTime": 690, "meetingContent": "内容1", "meetingTheme": "主题11", "meetingType": 0, "reservedDate": "2020-05-28", "roomId": "FVgM2cZFam8", "startTime": 676}”