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

1、全球眼系统接口文档中心管理服务器企业客户端接口说明修改人修改时间修改内容毕玮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

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的

3、协议，并增加了x,y,z的属性；增加5.4 更改用户视图的设备的属性刁良海2008-1-3登录时增加IP李占江2008-4-7用户登录指令请求时增加platformId参数，返回时增加platform信息目录TOC o 1-3 h z u HYPERLINK l _Toc187134346 1 用户登录 PAGEREF _Toc187134346 h 6 HYPERLINK l _Toc187134347 2 用户会话心跳 PAGEREF _Toc187134347 h 7 HYPERLINK l _Toc187134348 3 修改用户密码 PAGEREF _Toc187134348 h 7

4、 HYPERLINK l _Toc187134349 4 用户注销 PAGEREF _Toc187134349 h 8 HYPERLINK l _Toc187134350 5 读取机构层次列表 PAGEREF _Toc187134350 h 8 HYPERLINK l _Toc187134351 5.1 用户登陆后，首次读取机构层次列表（根据该用户所属机构取列表）： PAGEREF _Toc187134351 h 8 HYPERLINK l _Toc187134352 5.2 用户选择子机构后，读取子机构的机构层次列表： PAGEREF _Toc187134352 h 10 HYPERLINK

5、 l _Toc187134353 5.3 查询被禁用的设备 PAGEREF _Toc187134353 h 11 HYPERLINK l _Toc187134354 5.4 更改用户视图的设备的属性 PAGEREF _Toc187134354 h 11 HYPERLINK l _Toc187134355 5.5 可能出现的错误： PAGEREF _Toc187134355 h 12 HYPERLINK l _Toc187134356 6 读取资源详细信息 PAGEREF _Toc187134356 h 12 HYPERLINK l _Toc187134357 6.1 读取机构详细信息 PAGE

6、REF _Toc187134357 h 12 HYPERLINK l _Toc187134358 6.2 读取视频输入通道详细信息 PAGEREF _Toc187134358 h 14 HYPERLINK l _Toc187134359 6.3 读取视频输出通道详细信息 PAGEREF _Toc187134359 h 16 HYPERLINK l _Toc187134360 6.4 读取输入报警通道详细信息 PAGEREF _Toc187134360 h 16 HYPERLINK l _Toc187134361 6.5 读取输出报警通道详细信息 PAGEREF _Toc187134361 h

7、17 HYPERLINK l _Toc187134362 6.6 可能出现的错误： PAGEREF _Toc187134362 h 18 HYPERLINK l _Toc187134363 7 读取设备所在的视频服务器上的设备列表 PAGEREF _Toc187134363 h 18 HYPERLINK l _Toc187134364 8 取公司内（包括子机构内的）所有用户列表 PAGEREF _Toc187134364 h 19 HYPERLINK l _Toc187134365 9 读取用户未接收的报警信息记录数目 PAGEREF _Toc187134365 h 20 HYPERLINK

8、l _Toc187134366 10 读取用户未接收的报警信息 PAGEREF _Toc187134366 h 21 HYPERLINK l _Toc187134367 11 读取设备发出的报警事件的数目 PAGEREF _Toc187134367 h 22 HYPERLINK l _Toc187134368 12 读取设备发出的报警事件 PAGEREF _Toc187134368 h 23 HYPERLINK l _Toc187134369 13 企业客户端机构设置模块入口 PAGEREF _Toc187134369 h24 HYPERLINK l _Toc187134370 14 跨平台用

9、户查找 PAGEREF _Toc187134370 h 24 HYPERLINK l _Toc187134371 14.1 互连平台列表 PAGEREF _Toc187134371 h 24 HYPERLINK l _Toc187134372 14.2 跨平台用户查找 PAGEREF _Toc187134372 h 25 HYPERLINK l _Toc187134373 15 报警预案 PAGEREF _Toc187134373 h 25 HYPERLINK l _Toc187134374 15.1 创建预案 PAGEREF _Toc187134374 h 25 HYPERLINK l _T

10、oc187134375 15.2 修改预案 PAGEREF _Toc187134375 h 26 HYPERLINK l _Toc187134376 15.3 删除预案 PAGEREF _Toc187134376 h 27 HYPERLINK l _Toc187134377 15.4 查询预案列表 PAGEREF _Toc187134377 h 27 HYPERLINK l _Toc187134378 15.5 查询指定预案的详细信息 PAGEREF _Toc187134378 h 28 HYPERLINK l _Toc187134379 15.6 设置预案使用用户 PAGEREF _Toc1

11、87134379 h 29 HYPERLINK l _Toc187134380 15.7 用户权限查询(对于创建预案) PAGEREF _Toc187134380 h 30 HYPERLINK l _Toc187134381 16 类型关系 PAGEREF _Toc187134381 h 31 HYPERLINK l _Toc187134382 17 异常和错误描述 PAGEREF _Toc187134382 h 31说明：本文档描述 中心管理服务器（CMS） 为 企业客户端（EC） 提供的数据操作接口。CMS使用Http(s)协议、XML格式提供如下服务：用户登录请求URL：https:/h

12、ost:port/web_xml_interface/user_logon.xml?logonName=UserLogonName&password=UserPassword&bindSoftdog=1&IP=88& platformId=010006IP：如果客户端在内网，IP指内网IP。加入IP是为方便电信查询哪些网段有哪些IP在使用客户端。响应XML： 参数说明：bindSoftdog ：加密狗版本登录时添加参数项（可选）isAdmin 是否是企业管理员 0：否 1：是 priority 值是表示优先级的自然数NEndTime 表示帐号有效截止时间，如果没有此属性，表示该帐号永久有效。p

13、latformId 用户所属平台ID（用户首次使用企业客户端登录时不发送该参数）可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_ACCOUNT_ERRORFailedCode.USER_ACCOUNT_SUSPENDEDFailedCode.COMPANY_SUSPENDEDFailedCode.USER_SESSION_MAX_AMOUNT_EXCEEDEDFailedCode.ACCESS_SERVER_EXCEPTIONFailedCode.UNKNOWN_ERROR用户会话心跳请求URL：https:/host:port/we

14、b_xml_interface/user_session_heartbeat.xml?sessionId=0000000000000000000000000000007响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR修改用户密码请求URL：https:/host:port/web_xml_interface/change_user_password.xml?sessionId=0000000000000000000000000000007&

15、oldPassword=UserPassword&newPassword=password响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.USER_ACCOUNT_ERRORFailedCode.PARAMETER_VALUE_INVALIDEDFailedCode.UNKNOWN_ERROR用户注销请求URL：https:/host:port/web_xml_interface/user_logoff.xml?sessionId=00000000000000000

16、00000000000007响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.ACCESS_SERVER_EXCEPTIONFailedCode.UNKNOWN_ERROR读取机构层次列表地理信息系统：所的设备添加三个属性：x, y, z，分别表示经度，纬度，高度。用户登陆后，首次读取机构层次列表（根据该用户所属机构取列表）：版本1：请求URL：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?s

17、essionId=0000000000000000000000000000007响应XML： 版本2：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?sessionId=0000000000000000000000000000007&version=2响应XML： 说明：版本2返回用户所有的可以查看的机构用户选择子机构后，读取子机构的机构层次列表：版本1：请求URL：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?sessionId=0000000

18、000000000000000000000007&organId=0000000000000000000000000000002响应XML：版本2：请求URL：https:/host:port/web_xml_interface/organ_hiberarchy_info.xml?sessionId=0000000000000000000000000000007&organId=0000000000000000000000000000002&version=2响应XML：说明：版本2只返回机构下的设备，没有机构信息查询被禁用的设备请求URL：https:/host:port/web_xml_i

19、nterface/ get_forbid_dev_list.xml?sessionId=0000000000000000000000000000007响应XML：更改用户视图的设备的属性请求URL： HYPERLINK http:/host:port/web_xml_interface/update_device_info.xml?sessionId=%s&xml http:/host:port/web_xml_interface/update_device_info.xml?sessionId=%s&xml=:XML：设备的名称1000.102000.103200.20响应XML：TRUE可

20、能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.ORGAN_NOT_FOUNDFailedCode.UNKNOWN_ERROR读取资源详细信息读取机构详细信息请求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=0000000000000000000000000000007&resourceType=organ&resourceId=00000000000000000000000000

21、00001响应XML：根据机构类型的不同可能会有如下2种返回结果：是一个顶级机构（公司） 是一个非顶级机构（部门） 读取视频输入通道详细信息请求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=0000000000000000000000000000007&resourceType=video_input_channel&resourceId=0000000000000000000000000000001& naming=0000000000000000000000000000001:000000

22、0000000000000000000000003:010001响应XML：根据视频输入通道类型的不同可能会有如下4种返回结果：普通摄像头 矩阵摄像头，属性与普通摄像头相同，将general_camera_vic 改为 matrix_vic。 注：这个接口没有使用。IpCamera摄像头，属性与普通摄像头相同，general_camera_vic改为ip_camera_vic，并增加 host、port两个属性 IpCamera视频服务器摄像头，属性与IpCamera摄像头相同，将ip_camera_vic 改为ip_camera_video_server_vic。 读取视频输出通道详细信息请

23、求URL：https:/host:port/web_xml_interface/resource_detail_info.xml?sessionId=0000000000000000000000000000007&resourceType=video_output_channel&resourceId=0000000000000000000000000000001& naming=0000000000000000000000000000001:0000000000000000000000000000003:010001响应XML： 读取输入报警通道详细信息请求URL：https:/host:p

24、ort/web_xml_interface/resource_detail_info.xml?sessionId=0000000000000000000000000000007&resourceType=alarm_input_channel&resourceId=0000000000000000000000000000001&naming=0000000000000000000000000000001:0000000000000000000000000000003:010001响应XML： 读取输出报警通道详细信息请求URL：https:/host:port/web_xml_interfac

25、e/resource_detail_info.xml?sessionId=0000000000000000000000000000007&resourceType=alarm_output_channel&resourceId=0000000000000000000000000000001& naming=0000000000000000000000000000001:0000000000000000000000000000003:010001响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOU

26、NDFailedCode.RESOURCE_TYPE_UNKNOWNFailedCode.ORGAN_NOT_FOUNDFailedCode.VIC_NOT_FOUNDFailedCode.VOC_NOT_FOUNDFailedCode.AIC_NOT_FOUND FailedCode.AOC_NOT_FOUND FailedCode.UNKNOWN_ERROR读取设备所在的视频服务器上的设备列表请求URL：https:/host:port/web_xml_interface/vis_relating_device_list.xml?sessionId=00000000000000000000

27、00000000007&deviceType=alarm_input_channel&deviceId=0000000000000000000000000000001& naming=0000000000000000000000000000001:0000000000000000000000000000003:010001注意：deviceType := video_input_channel | alarm_input_channel | alarm_output_channel响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.U

28、SER_SESSION_NOT_FOUNDFailedCode.DEVICE_TYPE_UNKNOWNFailedCode.DEVICE_NOT_FOUNDFailedCode.UNKNOWN_ERROR取公司内（包括子机构内的）所有用户列表请求URL：https:/host:port/web_xml_interface/company_user_list.xml?sessionId=0000000000000000000000000000007响应XML： 可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FO

29、UNDFailedCode.UNKNOWN_ERROR读取用户未接收的报警信息记录数目取回用户上次登陆以来一共未确认接收的报警信息记录数目。请求URL：https:/host:port/web_xml_interface/user_unreceived_alarm_event_listnum.xml?sessionId=0000000000000000000000000000007响应XML：可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR读取用户未接收

30、的报警信息取回用户上次登陆以来某一天未确认接收的报警信息。请求URL：https:/host:port/web_xml_interface/user_unreceived_alarm_event_list.xml?sessionId=0000000000000000000000000000007&start=1&count=20响应XML： id=0000000000000000000000000000002sourceType=video_input_channel sourceId=0000000000000000000000000000001 sourceName=camera_1 st

31、artTime=1092347213211 endTime=1092347213211 KinescopeTime =1092347213211 AlarmOutTime=1092347213211 typeName=移动侦测报警 . 注：userName是用户名称，可能会有重复可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR读取设备发出的报警事件的数目取回某段时间内与某个用户相关联的一个设备的报警事件数目。注意：deviceType := video_

32、input_channel | alarm_input_channel 请求URL： HYPERLINK https:/host:port/web_xml_interface/device_alarm_event_listnum.xml?sessionId=0000000000000000000000000000007&deviceType=video_input_channel&deviceId=0000000000000000000000000000001&deviceNaming=0000000000000000000000000000001:0000000000000000000000

33、000000003:010001&beginTime=2005-12-2312:34:56&endTime=2006-12-23 https:/host:port/web_xml_interface/device_alarm_event_listnum.xml?sessionId=0000000000000000000000000000007&deviceType=video_input_channel&deviceId=0000000000000000000000000000001&deviceNaming=0000000000000000000000000000001:0000000000

34、000000000000000000003:010001&beginTime=2005-12-2312:34:56&endTime=2006-12-23 12:34:56响应XML：可能出现的错误：FailedCode.PARAMETER_NOT_FOUNDFailedCode.USER_SESSION_NOT_FOUNDFailedCode.UNKNOWN_ERROR读取设备发出的报警事件取回某段时间内与某个用户相关联的一个设备的报警事件列表。注意：deviceType := video_input_channel | alarm_input_channel 请求URL： HYPERLINK

35、 https:/host:port/web_xml_interface/device_alarm_event_list.xml?sessionId=0000000000000000000000000000007&deviceType=video_input_channel&deviceId=0000000000000000000000000000001&beginTime=1091677213211&endTime=1119850900218&start=1&count=20 https:/host:port/web_xml_interface/device_alarm_event_list.

36、xml?sessionId=0000000000000000000000000000007&deviceType=video_input_channel&deviceId=0000000000000000000000000000001&deviceNaming=0000000000000000000000000000001:0000000000000000000000000000003:010001&beginTime=2005-12-23 12:34:56&endTime=2006-12-23 12:34:56&start=1&count=20注意：deviceType := video_i

37、nput_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企业客户端机构设置模块入口请求URL： HYPERLINK https:/host:port/mega/enterpriseloginse

38、rvlet?sessionid=0000000000000000000000000000067 https:/host:port/mega/enterpriseloginservlet?sessionid=0000000000000000000000000000067跨平台用户查找互连平台列表请求URL： HYPERLINK https:/host:port/mega/platform_list.xml https:/host:port/mega/platform_list.xml 注：platformName全局唯一。跨平台用户查找请求URL：url?logonNamer=abc&userN

39、ame=abc&deviceNaming=0000000000000000000000000000003:010001&deviceType= video_input_channel 注：deviceType := video_input_channel | alarm_input_channeldeviceNaming是指事件产生源，摄像头或者报警器userName是用户名称，可能会有重复logonName、userName可填写其中任意一个，中心作模糊查询url内容为14.1中返回的url值报警预案创建预案请求URL： HYPERLINK https:/host:port/web_xml_

40、interface/create_scheme.xml?sessionId=%s&xml https:/host:port/web_xml_interface/create_scheme.xml?sessionId=%s&xml=XML：预案的备注动作列表响应XML：相关代码:com.megaeyes.managementserver.web.xmlinterface.servlet.CreateSchemeServletCmand.xmlinterface.AlarmScheme.CreateAlarmSchemeDmand.xmlinterface.AlarmScheme.CreateAl

41、armSchemeAction可能出现的错误:FailedCode.:USER_SESSION_NOT_FOUND修改预案请求URL： HYPERLINK https:/host:port/web_xml_interface/create_scheme.xml?sessionId=%s&xml https:/host:port/web_xml_interface/update_scheme.xml?sessionId=%s&xml=xml:预案的备注动作列表响应XML：相关代码:com.megaeyes.managementserver.web.xmlinterface.servlet.Upd

42、ateSchemeSmand.xmlinterface.AlarmScheme.UpdateAlarmSchemeAmand.xmlinterface.AlarmScheme.UpdateAlarmSchemeData可能出现的错误:FailedCode.:USER_SESSION_NOT_FOUND删除预案请求URL： HYPERLINK https:/host:port/web_xml_interface/ delete_scheme.xml?sessionId=%s&xml https:/host:port/web_xml_interface/ delete_scheme.xml?ses

43、sionId=%s&xml=xml:响应xml:相关代码:com.megaeyes.managementserver.web.xmlinterface.servlet.DeleteSchemeSmand.xmlinterface.AlarmScheme. DeleteAlarmSchemeAmand.xmlinterface.AlarmScheme.DeleteAlarmSchemeData查询预案列表请求URL：https:/host:port/web_xml_interface/get_set_scheme_list.xml?sessionid=响应XML：预案的备注 预案的备注 相关代码

44、:com.megaeyes.managementserver.web.xmlinterface.servlet.GetSetSchemeListSmand.xmlinterface.AlarmScheme. FindAlarmSchemeListByAuthUserAmand.xmlinterface.AlarmScheme. FindAlarmSchemeListByAuthUserData查询指定预案的详细信息请求URL：https:/host:port/web_xml_interface/scheme_info.xml?xml=XML：响应XML：预案的备注动作列表相关代码:com.me

45、gaeyes.managementserver.web.xmlinterface.servlet. GetSchemeInfoSmand.xmlinterface.AlarmScheme.FindAlarmSchemeByIdDmand.xmlinterface.AlarmScheme.FindAlarmSchemeByIdAction设置预案使用用户请求URL： HYPERLINK https:/host:port/web_xml_interface/find_user_name.xml?xml https:/host:port/web_xml_interface/set_scheme_use_user.xml?xml=XML： 用户sessionId响应XML：0相关代码:com.megaeyes.managementserver.web.xmlinterface.servlet. SetSchemUseUserSmand.xmlinterface.AlarmScheme.SetSchemeUseUserData;mand.xmlinterface.AlarmScheme.SetSchemeUseUserAction用户权限查询(对于创建预案)请求URL： HYPERLINK https:/host:port/web_xml_inte