会议预约管理

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"
         }
  • 然后点击 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。


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}”