附 录 A（资料性）电子标志牌管理系统的通讯接口与数据传递流程A.1 通讯接口电子标志牌管理系统的通讯接口如表A.1所示： 表A.1 通讯接口定义表Topic名称数据方向备注/mgmt/led/up电子标志牌发往电子标志牌管理系统电子标志牌上行消息发往同一个Topic，电子标志牌管理系统订阅该Topic消息/mgmt/led/down/{用户接入码}/{clientId}电子标志牌管理系统发往电子标志牌电子标志牌管理系统下行消息需发往对应电子标志牌专属Topic，终端订阅该Topic消息A.2 数据传递流程A.2.1 以用户接入码：100001，终端IMEI：0351521004992889为例，电子标志牌的数据传递流程如下：a）由道路客运经营主体自行选择电信运营商将电子标志牌接入公众移动通信网络，然后由电子标志牌按照接入 ID 规范生成 MQTT ClientID连接MQTT Broker 订阅消息，订阅的Topic名称为/mgmt/led/down/100001/ 0351521 004992889；b）电子标志牌管理系统订阅Topic:/mgmt/led/up的消息；c）电子标志牌发送登录请求消息到Topic:/mgmt/led/up，由电子标志牌管理系统认证处理后，发送登录响应消息到Topic:/mgmt/led/down/100001/ 0351521004992889；d）电子标志牌收到登录响应成功消息后，发送服务器授时请求消息到Topic:/mgmt/led/up，由电子标志牌管理系统发送服务器授时响应消息到Topic:/mgmt/led/down/100001/0351521004992889；e）电子标志牌管理系统根据业务功能发送对应的协议消息到Topic:/mgmt/led/down/100001 /0351521004992889；f）电子标志牌收到订阅消息后，进行消息解析和 LED 显示屏数据交互，实现业务功能处理后发送对应协议应答消息到 Topic:/mgmt/led/up；g） 电子标志牌管理系统收到电子标志牌应答消息后，进行消息解析及业务数据处理，完成业务功能流程处理。
A.2.2 电子标志牌管理系统和电子标志牌交互的数据流向如图A.1所示：图A.1 数据流向图附 录 B（资料性）电子标志牌追溯二维码承载信息接口与参数定义B.1 移动通信终端绑定系统账号接口接口描述：用于移动通信终端绑定电子标志牌管理系统账号请求URL：/api/v1/e-sign/account/bind请求方式：POST请求参数：见表B.1响应参数：见表B.2表B.1 请求参数表字段名变量名必填类型描述移动端用户标识identifier是字符型移动通信终端用户认证的号或其他唯一标识系统账号名称username是字符型电子标志牌管理系统账号名系统账号密码password是字符型电子标志牌管理系统账号密码表B.2 响应参数表字段名变量名必填类型描述账号绑定结果result是数字型绑定账号状态，见表B.5B.2 获取电子标志牌追溯二维码承载信息接口接口描述：用于移动通信终端扫描追溯二维码，获取客车的本运次道路客运相关追溯服务信息接口校验：电子标志牌管理系统根据用户数据库，对通过扫描追溯二维码查询信息的移动通信终端用户进行身份校验，检查是否已绑定电子标志牌管理系统账号，其中：a）校验通过的，可以完整获取客车的本运次道路客运经营信息；b）校验未通过的，只能获取客车的本运次车辆号码、驾驶人姓名、客运类型、起讫地及客运站点、中途停靠地客运站点等公开信息。
请求URL：/api/v1/e-sign/qrcode/info请求方式：POST请求参数：见表B.3响应参数：见表B.4对于已绑定电子标志牌管理系统账号的用户，返回以下全部信息字段；对于未绑定电子标志牌管理系统账号的用户，仅返回以下公开信息字段表B.3 请求参数表字段名变量名必填类型描述加密编码qrcode是字符型二维码中承载的加密编码信息移动端用户标识identifier是字符型移动通信终端用户认证的号或其他唯一标识表B.4 响应参数表字段名变量名必填类型是否公开信息描述车牌号licensePlate是字符型是担当本运次的客车号码车牌颜色plateColor是数字型是车牌颜色，见表B.6驾驶员姓名driverName是字符型是驾驶员姓名客运类型transportType是数字型是客运类型，见表B.7起始地客运站点startStationName否字符型否起始地客运站点名称起始地区划代码startStationZid是数字型是参照GB/T 2260终到地客运站点endStationName否字符型否终到地客运站点名称终到地区划代码endStationZid是字符型是参照GB/T 2260中途停靠地客运站点stationList否数组型否中途停靠地客运站点名称列表线路标志牌绑定期起dispatchStart是数字型是起始日期yyyyMMdd线路标志牌绑定期止dispatchEnd是数字型是截止日期yyyyMMdd包车运次开始时间bookStartTime否数字型否开始时间yyyyMMddhhmmss包车运次结束时间bookEndTime否数字型否结束时间yyyyMMddhhmmss标志牌编号signId否字符型否标志牌编号经营业户businessOwner否字符型否经营业户名称经营区域businessZone否数字型否经营区域，见表B.8经营线路名称businessLineName否字符型否经营线路名称经营期限起validStartDate否数字型否经营期限起始日期yyyyMMdd经营期限止validEndDate否数字型否经营期限截止日期yyyyMMddB.3 字典表电子标志牌追溯二维码承载信息接口的字典表见表B.5、表B.6、表B.7、表B.8。
表B.5 账号绑定状态定义账号绑定状态代码绑定成功1绑定失败2表B.6 车牌颜色代码定义车牌颜色代码蓝色1黄色2黑色3白色4绿色5其他9黄绿色93渐变绿94表B.7 客运类型定义表客运类型代码班车客运1包车客运2定制客运3旅游客运4表B.8 经营区域定义表标志牌类型代码省际1市际2县际3县内4。
