校车接口规范-韶关.docVIP

校车监控平台数据接口协议V1.0  PAGE \* MERGEFORMAT 6 校车监控平台数据接口协议接口协议：Socket通信方式 概述 参照《DB44/T 769—2010重点监管车辆监控平台数据接口规范》结合校车监控实际需要，制定本协议。 本协议规定了GPS营运商或运输企业监控平台(以下简称监控平台)与校车基准平台(以下简称校车基准平台)之间以Socket通信方式进行数据交换的接口协议。 数据传输约定 通信约定 通信协议采用TCP/IP协议，监控平台和校车基准平台之间保持在线连接。 登录 登录是指监控平台向校车基准平台登录。 监控平台登录时，向校车基准平台发送“登录请求”（LoginREQ），校车基准平台验证登录请求的OMC代码、IP地址、用户帐号、密码以及随机序列，确认合法性后，向监控平台返回“登录回应”（LoginRSP）。若登录成功，校车基准平台将接收并处理监控平台上报的数据，反之，将丢弃监控平台上报的数据，并强制断开与监控平台建立的连接。 链路检测 链路检测是指监控平台与校车基准平台之间的网络链路检测。 监控平台登录后，需每隔1分钟向校车基准平台发送“链路检测请求”（TestLinkREQ）；校车基准平台收到链路检测请求后，向监控平台回应“链路检测回应”（TestLinkRSP），告知监控平台链路正常。如果监控平台连续发送3个的链路检测请求都没收到回应，则可认为与校车基准平台连接中断，可尝试重新登录校车基准平台。 安全认证 安全认证是为保障监控平台接入校车基准平台的合法性认证，具体流程如下。 校车基准平台为各监控平台分配用户帐号、密码。 监控平台与校车基准平台建立连接后，校车基准平台校验连接IP，对非法IP将强行断开，对合法IP连接产生一个随机序列（10字节字符串）发送给监控平台，监控平台将事先分配的帐号、密码与随机序列按先后顺序组合后进行MD5加密，并向校车基准平台发出“登录请求”，校车基准平台接收到登录请求后，验证用户帐号、密码和随机序列的正确性，如果不合法，则认证失败。 校车基准平台收到登录请求后，先验证IP地址，如果IP与约定的不一致，则认证失败。 校车基准平台对于建立链接后，对最近2分钟内未发送“登陆申请或递交链路检测请求”的监控平台强制断开链接处理。 同一IP只允许一个连接成功。 数据编码 对字符串数据采用GBK编码（兼容ASCII及GB2312编码）。 对不定长数据字段，如果可能出现保留的分隔符，则需采用BASE64进行二次编码，防止和保留的分隔符产生歧义。数据长度按进行BASE64编码后的长度计算。数据协议中对需进行BASE64编码的字段特别注明。 对固定长度字符串，不足部分后面补0x00。 对多字节整数类型，高位在前，低位在后，不足部分前面补0x00。 消息格式中“数据”字段前后为固定长度，分隔符仅作协议合法性校验。 消息格式中“数据”字段中含有不定长字段，分隔符作字段识别作用，除特别注明外，必须确保不定长字段中不含分隔符。 数据协议框架 消息格式 消息格式定义 其中数据长度是数据的总字节数。 功能关键字：3字节，字符串，如“U01”； 企业监控平台代码：即OMC代码，4字节，字符串，如“0001”，由政府职能部门指定机构统一分配。 数据长度：4字节，字符串，如“0001”。 数据格式 数据格式定义 协议字符 开始符：“~”； 结束符：“#”； 分隔符：“”； 数据分隔符：“|”。 功能关键字 功能关键字采用分类标识+2字节序号，如U01。 功能关键字分类定义 标识字符说明LLogin首字母，监控平台与校车基准平台之间的登录数据标识TTestLink首字母，监控平台与校车基准平台之间的链路检测数据标识UUpload首字母，监控平台向校车基准平台上传的数据标识DDownload首字母，监控平台下载校车基准平台下传的数据标识 登录流程 登录流程图 如登录不成功，则校车基准平台强制断开监控平台的TCP连接。连接断开后重连时，需要重新发起登录申请。 登录数据协议 登录随机序列 登录随机序列说明表 关键字L00数据字段1字段名称随机序列说明由校车基准平台随机产生的字符串序列长度固定长度10 字节登录请求 登录请求协议说明表 关键字L01数据字段1字段名称用户名说明由政府职能部门指定机构统一分配长度不定长数据字段2字段名称密码说明由政府职能部门指定机构统一分配，用户名＋密码＋随机序列字符串的MD5码,MD5码中字母部分约定为小写。长度固定长度32字节数据字段3字段名称随机序列说明来自校车基准平台随机产生的字符串序列长度固定长度10 字节登录回应 校车基准平台收