企业客户端与中心管理服务器协议

全球眼系统接口文档中心管理服务器企业客户端接口说明修改人修改时间修改内容毕玮2005-6-27毕玮2005-9-6naming赵向鹏2005-11-3用户登录接口增加是否企业管理员属性赵向鹏2005-11-15用户未接受报警接口增加报警结束时间以及增加参数date指定取某一天的数据么永辉 2005-12-11:用户未接收的报警信息接口中增加录像时间2:读取设备发出的报警事件中增加录像时间么永辉2005-12-21: 读取用户未接收的报警信息中增加了关联摄像头列表2:读取设备发出的报警事件中增加了企业用户提交的报警意见信息列表赵向鹏2006-4-5命名信息中添加平台id魏婕2006-4-196.2、6.3、6.4、6.5、7请求url中增加naming项魏婕2006-5-12增加14在11、12中在增加deviceNaming项魏婕2006-5-12修改10、12 ，将返回的报警信息填写完整。修改14.2，返回信息中增加organName胡志强2007-1-11增加报警预案朴希闯2007-5-2在第5章添加GIS坐标属性朴希闯2007-5-4第一章添加date参数李建全2007-5-9用户登录,增加优先级朴希闯2007-7-265.1 5.2节添加是否支持预案属性刘玄勒2007-8-305.3 查询被禁用的设备赵永强2008-1-31节，用户登陆返回用户的id5.1和5.2新增版本2的协议，并增加了x,y,z的属性； 增加5.4 更改用户视图的设备的属性刁良海2008-1-3登录时增加IP李占江2008-4-7用户登录指令请求时增加platformId参数，返回时增加platform信息目录1 用户登录62 用户会话心跳73 修改用户密码74 用户注销85 读取机构层次列表85.1 用户登陆后，首次读取机构层次列表（根据该用户所属机构取列表）：85.2 用户选择子机构后，读取子机构的机构层次列表：105.3 查询被禁用的设备115.4 更改用户视图的设备的属性115.5 可能出现的错误：126 读取资源详细信息126.1 读取机构详细信息126.2 读取视频输入通道详细信息146.3 读取视频输出通道详细信息166.4 读取输入报警通道详细信息166.5 读取输出报警通道详细信息176.6 可能出现的错误：187 读取设备所在的视频服务器上的设备列表188 取公司内（包括子机构内的）所有用户列表199 读取用户未接收的报警信息记录数目2010 读取用户未接收的报警信息2111 读取设备发出的报警事件的数目2212 读取设备发出的报警事件2313 企业客户端机构设置模块入口2414 跨平台用户查找2414.1 互连平台列表2414.2 跨平台用户查找2515 报警预案2515.1 创建预案2515.2 修改预案2615.3 删除预案2715.4 查询预案列表2715.5 查询指定预案的详细信息2815.6 设置预案使用用户2915.7 用户权限查询(对于创建预案)3016 类型关系3117 异常和错误描述31说明：本文档描述 中心管理服务器（CMS） 为 企业客户端（EC） 提供的数据操作接口。CMS使用Http(s)协议、XML格式提供如下服务：1 用户登录请求URL：https:/host:port/web_xml_interface/user_logon.xml?logonName=UserLogonName&password=UserPassword&bindSoftdog=1&IP=88& platformId= IP：如果客户端在内网，IP指内网IP。加入IP是为方便电信查询哪些网段有哪些IP在使用客户端。响应XML： 参数说明：bindSoftdog ：加密狗版本登录时添加参数项（可选）isAdmin 是否是企业管理员 0：否 1：是 priority 值是表示优先级的自然数NEndTime 表示帐号有效截止时间，如果没有此属性，表示该帐号永久有效。platformId 用户所属平台ID（用户首次使用企业客户端登录时不发送该参数）可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_ACCOUNT_ERRORFailedCode.USER_ACCOUNT_SUSPENDEDFailedCode.COMPANY_SUSPENDEDFailedCode.USER_SESSION_MAX_AMOUNT_EXCEEDEDFailedCode.ACCESS_SERVER_EXCEPTIONFailedCode.UNKNOWN_ERROR2 用户会话心跳请求URL：https:/host:port/web_xml_interface/user_session_heartbeat.xml?sessionId=响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR3 修改用户密码请求URL：https:/host:port/web_xml_interface/change_user_password.xml?sessionId=&oldPassword=UserPassword&newPassword=password响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.USER_ACCOUNT_ERRORFailedCode.PARAMETER_VALUE_INVALIDEDFailedCode.UNKNOWN_ERROR4 用户注销请求URL：https:/host:port/web_xml_interface/user_logoff.xml?sessionId=响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.ACCESS_SERVER_EXCEPTIONFailedCode.UNKNOWN_ERROR5 读取机构层次列表地理信息系统：所的设备添加三个属性：x, y, z，分别表示经度，纬度，高度。5.1 用户登陆后，首次读取机构层次列表（根据该用户所属机构取列表）：版本1：请求URL：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?sessionId=响应XML： 版本2：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?sessionId=&version=2响应XML： 说明：版本2返回用户所有的可以查看的机构5.2 用户选择子机构后，读取子机构的机构层次列表：版本1：请求URL：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?sessionId=&organId=响应XML：版本2：请求URL：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?sessionId=&organId=&version=2响应XML：说明：版本2只返回机构下的设备，没有机构信息5.3 查询被禁用的设备请求URL：https:/host:port/web_xml_interface/ get_forbid_dev_list.xml?sessionId=响应XML：5.4 更改用户视图的设备的属性请求URL：http:/host:port/web_xml_interface/update_device_info.xml?sessionId=%s&xml=:XML：设备的名称1000.102000.103200.20响应XML：TRUE5.5 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.ORGAN_NOT_FOUNDFailedCode.UNKNOWN_ERROR6 读取资源详细信息6.1 读取机构详细信息请求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=&resourceType=organ&resourceId=响应XML：根据机构类型的不同可能会有如下2种返回结果：1） 是一个顶级机构（公司） 2） 是一个非顶级机构（部门） 6.2 读取视频输入通道详细信息请求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=&resourceType=video_input_channel&resourceId=& naming=::响应XML：根据视频输入通道类型的不同可能会有如下4种返回结果：1） 普通摄像头 2） 矩阵摄像头，属性与普通摄像头相同，将general_camera_vic 改为 matrix_vic。 注：这个接口没有使用。3） IpCamera摄像头，属性与普通摄像头相同，general_camera_vic改为ip_camera_vic，并增加 host、port两个属性 4） IpCamera视频服务器摄像头，属性与IpCamera摄像头相同，将ip_camera_vic 改为ip_camera_video_server_vic。 6.3 读取视频输出通道详细信息请求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=&resourceType=video_output_channel&resourceId=& naming=::响应XML： 6.4 读取输入报警通道详细信息请求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=&resourceType=alarm_input_channel&resourceId=& naming=::响应XML： 6.5 读取输出报警通道详细信息请求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=&resourceType=alarm_output_channel&resourceId=& naming=::响应XML： 6.6 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.RESOURCE_TYPE_UNKNOWNFailedCode.ORGAN_NOT_FOUNDFailedCode.VIC_NOT_FOUNDFailedCode.VOC_NOT_FOUNDFailedCode.AIC_NOT_FOUND FailedCode.AOC_NOT_FOUND FailedCode.UNKNOWN_ERROR7 读取设备所在的视频服务器上的设备列表请求URL：https:/host:port/web_xml_interface/vis_relating_device_list.xml?sessionId=&deviceType=alarm_input_channel&deviceId=& naming=::注意：deviceType := video_input_channel | alarm_input_channel | alarm_output_channel响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.DEVICE_TYPE_UNKNOWNFailedCode.DEVICE_NOT_FOUNDFailedCode.UNKNOWN_ERROR8 取公司内（包括子机构内的）所有用户列表请求URL：https:/host:port/web_xml_interface/company_user_list.xml?sessionId=响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR9 读取用户未接收的报警信息记录数目取回用户上次登陆以来一共未确认接收的报警信息记录数目。请求URL：https:/host:port/web_xml_interface/user_unreceived_alarm_event_listnum.xml?sessionId=响应XML：可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR10 读取用户未接收的报警信息取回用户上次登陆以来某一天未确认接收的报警信息。请求URL：https:/host:port/web_xml_interface/user_unreceived_alarm_event_list.xml?sessionId=&start=1&count=20响应XML： id= sourceType=video_input_channel sourceId= sourceName=camera_1 startTime=11 endTime=11 KinescopeTime =11 AlarmOutTime=11 typeName=移动侦测报警 . 注：userName是用户名称，可能会有重复可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR11 读取设备发出的报警事件的数目取回某段时间内与某个用户相关联的一个设备的报警事件数目。注意：deviceType := video_input_channel | alarm_input_channel 请求URL：https:/host:port/web_xml_interface/device_alarm_event_listnum.xml?sessionId=&deviceType=video_input_channel&deviceId=&deviceNaming=::&beginTime=2005-12-23 12:34:56&endTime=2006-12-23 12:34:56响应XML：可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR12 读取设备发出的报警事件取回某段时间内与某个用户相关联的一个设备的报警事件列表。注意：deviceType := video_input_channel | alarm_input_channel 请求URL：https:/host:port/web_xml_interface/device_alarm_event_list.xml?sessionId=&deviceType=video_input_channel&deviceId=&deviceNaming=::&beginTime=2005-12-23 12:34:56&endTime=2006-12-23 12:34:56&start=1&count=20注意：deviceType := video_input_channel | alarm_input_channel响应XML：同10可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.PARAMETER_VALUE_INVALIDEDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.DEVICE_TYPE_UNKNOWNFailedCode.DEVICE_NOT_FOUNDFailedCode.UNKNOWN_ERROR 13 企业客户端机构设置模块入口请求URL：https:/host:port/mega/enterpriseloginservlet?sessionid=14 跨平台用户查找14.1 互连平台列表请求URL：https:/host:port/mega/platform_list.xml 注：platformName全局唯一。 14.2 跨平台用户查找请求URL：url?logonNamer=abc&userName=abc&deviceNaming=::&deviceType= video_input_channel 注：deviceType := video_input_channel | alarm_input_channeldeviceNaming是指事件产生源，摄像头或者报警器userName是用户名称，可能会有重复logonName、userName可填写其中任意一个，中心作模糊查询url内容为14.1中返回的url值15 报警预案15.1 创建预案请求URL：https:/host:port/web_xml_interface/create_scheme.xml?sessionId=%s&xml=XML：预案的备注动作列表响应XML：相关代码: com.megaeyes.managementserver.web.xmlinterface.servlet. CreateSchemeServlet Cmand.xmlinterface.AlarmScheme. CreateAlarmSchemeData mand.xmlinterface.AlarmScheme. CreateAlarmSchemeAction可能出现的错误:FailedCode.:USER_SESSION_NOT_FOUND15.2 修改预案请求URL： https:/host:port/web_xml_interface/update_scheme.xml?sessionId=%s&xml=xml:预案的备注动作列表响应XML：相关代码:com.megaeyes.managementserver.web.xmlinterface.servlet.UpdateSchemeSmand.xmlinterface.AlarmScheme.UpdateAlarmSchemeAmand.xmlinterface.AlarmScheme.UpdateAlarmSchemeData可能出现的错误:FailedCode.:USER_SESSION_NOT_FOUND15.3 删除预案请求URL：https:/host:port/web_xml_interface/ delete_scheme.xml?sessionId=%s&xml=xml:响应xml:相关代码:com.megaeyes.managementserver.web.xmlinterface.servlet.DeleteSchemeSmand.xmlinterface.AlarmScheme. DeleteAlarmSchemeAmand.xmlinterface.AlarmScheme. DeleteAlarmSchemeData15.4 查询预案列表请求URL：https:/host:port/web_xml_interface/get_set_scheme_list.xml?sessionid=响应XML：预案的备注 预案的备注 相关代码: com.megaeyes.managementserver.web.xmlinterface.servlet.GetSetSchemeListSmand.xmlinterface.AlarmScheme. FindAlarmSchemeListByAuthUserAmand.xmlinterface.AlarmScheme. FindAlarmSchemeListByAuthUserData15.5 查询指定预案的详细信息请求URL：https:/host:port/web_xml_interface/scheme_info.xml?xml=XML：响应XML：预案的备注动作列表相关代码:com.megaeyes.managementserver.web.xmlinterface.servlet. GetSchemeInfoSmand.xmlinterface.Ala