1. 会议室预定

会议助手暴露公共接口给第三方, 第三方通过调用该接口获取自己工作圈的会议室的预定信息, 用于展示。 所有请求均通过云之家通用的第三方鉴权方式，oauth2 鉴权， 详情如：https://open.yunzhijia.com/openplatform/resourceCenter/doc#/gitbook-wiki/server-api/accessToken.html
获取 token后 作为url参数 再调用以下接口所有请求与响应的格式均为json

接口为http 接口，接口配置了灰度名单, 请需要调用的客户联系云之家会议助手的开发工作人员配置灰度名单.

客户->云之家: 轮询/api/roomBook/third/hasNew
云之家-->客户: 是否有会议预定信息
Note left of 客户: 有新增会议室预定信息的情况
客户->云之家: 查询/api/roomBook/third/bookInfo
云之家-->客户: 返回会议预定信息列表(分页返回)

1.1. 判断该工作圈是否有新增会议预定信息

URL: /api/roomBook/third/hasNew

post请求, json格式参数. 查询某个会议的与会人

请求:

{
    "eid":"10109",  //必填, 工作圈eid
    "lastTime":"1538064000000"  //选填, 判断该时间节点之后是否有新增预定信息
    //最后的时间(可根据/roombook/api/third/bookInfo接口获取的最后一条信息的updateTime)
}

返回:

{
    "success": true,
    "errorCode": 0,
    "error": "",
    "data": {
        "hasNew": true   // boolean 是否有新的会议预定信息
    }
}

1.2. 获取该时间节点之后的预定信息

URL: /api/roomBook/third/bookInfo

post请求, json格式参数. 查询某个会议的与会人

请求:

{
    "eid":"10109",  //必填, 工作圈eid
    "lastTime":"1538064000000"  //选填, 最后的时间戳, 不填 则返回所有会议预定信息
    "pageIndex": 1  //选填, 默认1
    "pageSize":50   //选填, 默认50
}

返回:

{
    "success": true,
    "errorCode": 0,
    "error": "",
    "data": {
        "add": [
            {
                "orderId":"eeafjkdslfjsldjfdsf",  //会议预定订单id
                "roomName": "23F会议室",    //会议室名称
                "roomDetail": null,         //会议室地址
                "day": "2018-09-29",        //会议日期
                "userName": "何****",       //预定人姓名
                "eid": "10109",             //工作圈eid
                "startTime": 1538202600000, //会议开始时间
                "endTime": 1538209800000,   //会议结束时间
                "createTime": 1538201890395,//预定时间
                "updateTime": 1538201890395,//修改时间
                "meetingTopic": "云*****论",//会议主题
                "meetingContent": "*****"   //会议内容
            }...
        ],
        "delete": [
            {
                "orderId":"eeafjkdslfjsldjfdsf",  //会议预定订单id
                "roomName": "A304",
                "roomDetail": "A栋-3F",
                "day": "2018-09-28",
                "userName": "符**",
                "eid": "10109",
                "startTime": 1538121600000,
                "endTime": 1538125200000,
                "createTime": 1538201890395,
                "updateTime": 1538201890395,
                "meetingTopic": "商学院*******",
                "meetingContent": "商学院*******"
            }...
        ]
    }
}

1.3. 查询该工作圈空闲的会议室

URL: /api/roomBook/third/freeRooms

post请求, json格式参数. 查询某个会议的与会人

请求:

{
   "openId":"fsdfsdfdsfsdfdsfewfaga",  //必填，预约人员信息openId，
   "startTime": 1538121600000,
   "endTime": 1538125200000,
   "pageIndex": 1,  //选填, 默认1
   "pageSize":50   //选填, 默认50
}

返回:

{
    "success": true,
    "errorCode": 0,
    "error": "",
    "data": [
        {
            "note": "小猪佩",
            "roomDetail": "啊啊啊啊啊",
            "tagId": null,
            "limitCount": 99999999,
            "approve": true,
            "roomId": "5c121cfd7453ed63750a9767",
            "roomName": "冥王星1号"
        },...
    ]
}

1.4. 查询某个会议的与会人

URL: /api/roomBook/third/getActors

post请求, json格式参数. 查询某个会议的与会人

请求:

{
    "orderId":"fsdfsdfdsfsdfdsfewfaga"  //必填，会议订单id，
}

返回:

{
    "success": true,
    "errorCode": 0,
    "error": "",
    "data": [
        {
            "openId": "5c32b90b84aef86b358bc9cc",
            "headerUrl": "http://192.168.22.144/space/c/photo/load?id=54f7b6b116b2e39217000002",
            "userName": "陈*波"
        },
        {
            "openId": "5b652863e4b0689c4f38b1d3",
            "headerUrl": "http://192.168.22.144/space/c/photo/load?id=5b602f57b6238e0c44043f51",
            "userName": "陈*略"
        }
    ]
}