JT-T-979.1-2015道路客运联网售票系统第1部分：服务接口规范

ICS35.240.60JT/T979.1—2015道路客运联网售票系统第1部分：服务接口规范Part1:Serviceinterfacespecifications2015-07-11发布JT/T979.1—2015 Ⅱ 12规范性引用文件 13术语、定义和缩略语 13.1术语和定义 1 2 24.1总体架构 2 3 84.4性能要求 4.5安全要求 5接口规范 5.1接口方式与机制 5.2接口响应请求状态码 5.3传输协议 5.4数据格式 5.5连接方式 5.6技术实现 6接口类型及报文协议 6.1接口类型 6.2报文结构 附录A(规范性附录)接口技术实现语法格式 IⅡJT/T979.1—2015 本部分为JT/T979的第1部分。本标准按照GB/T1.1—2009给1JT/T979.1—2015道路客运联网售票系统GB/T25070信息安全技术信息系统等级保护安全设计技术要求JT/T697.7—2014交通信息基础数据元第7部分：道路运输信息基础数据元JT/T979.2道路客运联网售票系统第2部分：信息数据元RFC2616超文本传输协议HTTP1.1(HypertextTransferProtocol—HTTP/1.1).23.1.3请求request3.1.4响应response3.1.52JT/T979.1—20153.1.6服务接口serviceinterface3.1.7用于获取信息资源的一种HTTP请求方法。3.1.8用于更新资源信息的一种HTTP请求方法。4.1总体架构系统。图1给出了道路客运联网售票系统的组成，主要由以下5个部分构成：3JT/T979.1—2015道路客运联网售票系统道路客运联网售票系统联网售票应用系统售票服务系统联网售票业务管理系统客运信息监测服务系统清分结算系统联网售票数据资源库基础数据库业务数据库主题数据库交换数据库联网售票数据交换子系统联网售票前置服务子系统联网售票服务接口联网售票数据交换接口票源系统客运站站务管理系统票源地图1道路客运联网售票系统组成4.2系统业务功能及流程4.2.1班次列表查询业务说明车站查询，取得符合条件的车辆班次。如果班次列表查询取得班次成功后，联动到查询班次详情交易。否则输入条件重新查询。业务流程图班次列表查询业务流程如图2所示。4.2.2班次详情查询业务说明件的车辆班次详情，包括班次、余座等信息。如果查询班次取得详细信息成功且具备锁定票源的条件业务流程图班次详情查询业务流程如图3所示。4JT/T979.1—2015开始班次列表查询请求查询符合条件班次信息班次列表查询返回NY联动到查询班次详情发起售票查询返回报文票库图2班次列表查询业务流程图联网售票客户端联网售票客户端开始发送查询班次查询请求班次详情查询返回查询班次详情返回处理N符合条件班次Y发起查询班次详情返回报文查询符合条件班次信息前置机图3班次详情查询业务流程图4.2.3锁定票源根据查询班次详情得到符合条件的汽车班次，由用户选择合适班次的购票数量、座位类型等信息，业务流程图锁定票源业务流程如图4所示。5JT/T979.1—2015联网售票客户端联网售票客户端开始锁定票源请求发送锁定票源请求锁定票源返回N锁定成功Y联动到售票交易发起锁定票源返回报文处理锁定票源请求前置机图4锁定票源业务流程图4.2.4解锁票源业务说明业务流程图解锁票源业务流程如图5所示。开始解锁票源请求解锁票源返回解锁票源处理N解锁成功Y发起解锁票源返回报文票库图5解锁票源业务流程图6JT/T979.1—20154.2.5售票交易业务说明业务流程图售票交易业务流程如图6所示。联网售票客户端联网售票客户端开始售票交易请求发送售票请求发起售票返回报文N<Y显示错误信息结束售票交易返回售票返回处理是否成功售票打印车票售票处理前置机票库结束图6售票交易业务流程图4.2.6退票查询业务说明用户成功购买车票后，由于某种原因想要退票则需要进行此操作。查询取得该车票的状态，决易结束。业务流程图退票查询业务流程如图7所示。4.2.7退票交易业务说明业务流程图退票交易业务流程如图8所示。7JT/T979.1—2015联网售票客户端联网售票客户端开始退票查询请求发送退票查询请求发起退票查询返回报文是否可以退票Y显示错误信息结束联动到退票交易退票查询返回处理退票查询返回退票查询处理前置机票库N图7退票查询业务流程图联网售票客户端联网售票客户端开始退票交易请求发送退票请求退票交易返回发起退票返回报文是否成功退票Y打印退票信息结束显示错误信息退票返回处理退票处理前置机票库N图8退票交易业务流程图4.2.8销票查询业务说明8JT/T979.1—2015业务流程图销票查询业务流程如图9所示。联网售票客户端联网售票客户端开始销票查询请求发送销票查询请求销票查询返回发起销票查询返回报文N是否可以销票Y销票交易结束销票查询返回处理销票查询处理显示错误信息前置机票库图9销票查询业务流程图4.2.9销票交易业务说明业务流程图销票交易业务流程如图10所示。4.2.10订单查询业务说明业务流程图订单查询业务流程如图11所示。4.3功能要求4.3.1联网售票前置服务子系统应包含联网售票服务接口和联网售票数据交换接口两个接口。联网售票服务接口对外提供联网售票源地与道路客运联网售票系统的数据交换与共享。9JT/T979.1—2015联网售票客户端联网售票客户端开始销票交易请求发送销票请求销票交易返回销票返回处理N是否成功销票Y结束结束前置机票源地服务接口发起销票返回报文显示错误信息销票处理图10销票交易业务流程图联网售票客户端联网售票客户端开始订单查询请求发送订单查询请求订单查询返回处理N是否成功Y结束结束前置机票源地服务接口发起订单查询返回报文订单查询返回订单查询处理显示错误信息图11订单查询业务流程图4.3.2联网售票数据交换子系统接入联网售票数据交换接口，实现票源地与道路客运联网售票系统的数据交换，并提供道路客运联网售票系统与运政管理系统等行业内部系统以及其他外部系统的数据交换服务。支持不同类型的数据JT/T979.1—20154.3.3联网售票数据资源库基础数据库基础数据库应符合JT/T979.2规定的数据元要求。业务数据库符合JT/T979.2规定的数据元要求。主题数据库库应符合JT/T979.2规定的数据元要求。交换数据库应包括与其他系统进行交换的缓存数据，分为交换到其他系统的数据和从其他系统交换过来的数据。交换数据库应符合JT/T979.2规定的数据元要求。4.3.4联网售票应用系统售票服务系统联网售票业务管理系统等);监控票源地联网售票服务的运行状态；控制接入道路客运联网售票系统的各类售票渠道的售票客运信息监测服务系统线、票价等数据进行关联，综合反映道路客运各类统计指标(包括实载率、周转量等清分结算系统道路客运联网售票系统性能应满足以下要求：——系统的可用性应大于99.5%;——系统具有高并发业务请求响应和海量数据处理能力，能同时支持多种渠道的订票和购票并发4.5安全要求道路客运联网售票系统的安全性应符合GB/T25070规定的第二级或更高级别系统安全保护环境设计要求。JT/T979.1—20155接口规范道路客运联网售票系统采用面向服务的架构(SOA),各系统之间采用基于HTTP协议的网络服务实现上也可通过HTTP状态码返回当前服务状态，实际应用中可根据数据库建库规范中规定的范围增加。HTTP状态码是用以表示网页服务器HTTP响应状态的3位数字代码，由RFC2616规范定义。服务调用成功请求格式错误未授权访问不可识别服务器拒绝访问指定的资源未找到请求超时服务器内部错误响应超时服务器产生业务错误服务器产生业务异常注1:550和560状态码是本标准自定义的错误码，该自定义状态码符合HTTP协议的规范。注2:550表示产生了可以预见的业务错误，比如余票数不足这样的错误。错误描述和错误号在HTTP响应体中返回。注3:560表示产生了不可预见的业务异常，业务异常的详细错误和错误调用堆栈在HTTP响应体中返回。道路客运联网售票系统传输协议应采用HTTP协议。JT/T979.1—2015道路客运联网售票系统应支持HTTP的POST方式进行连接。道路客运联网售票系统可支持HTTP的GET方式进行连接。GET方式是以实体的格式获取被请求URI(Request-URI)制定的信息。5.6技术实现道路客运联网售票系统接口应采用OpenURL技术实现。接口技术实现语法格式详见附录A。6接口类型及报文协议6.1接口类型接口类型及其规定见表2。URI实时/非实时1班次列表查询LIST联网售票客户端票源地服务接口实时2班次详情查询DETAIL联网售票客户端票源地服务接口实时3锁定票源LOCK联网售票客户端票源地服务接口实时4解锁票源UNLOCK联网售票客户端票源地服务接口实时5售票交易SALE联网售票客户端票源地服务接口实时6退票查询GETRET联网售票客户端票源地服务接口实时7退票交易RETTI联网售票客户端票源地服务接口实时8销票查询GETCLE联网售票客户端票源地服务接口实时9销票交易CLETI联网售票客户端票源地服务接口实时订单查询QUERY联网售票客户端票源地服务接口实时6.2报文结构哪些类型的信息。如Accept:image/gif,表明客户端希望接受GIF图象格式的资源。HTTP消息报头中Accept的规范见表3。JT/T979.1—2015表3Accept规范表Acceptapplication/xml表明，接收和返回的XML类型数据application/json表明，接收和返回的JSON类型数据6.2.2请求正文支持格式请求正文支持XML和JSON两种格式，每个请求由公共请求信息和接口请求信息组成。XML格式XML格式请求正文具体形式如下所示：<?xmlversion="1.0"encoding="UTF-8"?><request><pubrequest><!-公共请求信息--></pubrequest><body><!-接口信息--></body></request>注：pubrequest节点描述公共请求信息，body节点描述接口请求，不同接口的标签名作为body下的属性的节点名称。JSON格式JSON格式请求正文具体形式如下所示：{"pubrequest":{},"body":{}}6.2.3响应正文支持格式响应正文支持XML和JSON格式，每个响应正文分为公共返回信息和接口返回信息。XML格式XML格式响应正文具体形式如下所示：<?xmlversion="1.0"encoding="UTF-8"?><response><pubresponse><!-公共请求信息--></pubresponse><body><!-接口信息--></body></response>JT/T979.1—2015JSON格式{"pubresponse":{},"body":{}}JT/T979.1—2015(规范性附录)接口技术实现语法格式A.1接口技术实现公共信息A.1.1公共请求公共请求信息内容定义见表A.1。表A.1公共请求信息内容发起渠道联网售票、网上售票、自助终端，电话，短信，手机客户端等发起公司代码具体经办售票、退票、销票等交易的代售点或道路客运联网售票系统操作员代码具体经办售票、退票、销票等交易的操作人工号或柜员代码票源公司代码售票、退票、销票等交易中票源所在的道路客运联网售票系统发送时间请求时间，YYYYMMDDhhmmss版本指明接口版本号校验信息用于校验数据的完整性身份令牌用于校验用户的真实性预留—A.1.2公共返回公共返回信息内容定义见表A.2。表A.2公共返回信息内容返回码见5.2接口响应请求状态码返回信息返回代码的说明返回时间返回时间，格式：YYYYMMDDhhmmss版本指明接口版本号校验信息用于校验数据的完整性预留JT/T979.1—2015A.2接口技术实现详细语法格式A.2.1班次列表查询A.2.1.1语法格式A.2.1.2请求内容班次列表查询请求内容定义见表A.3。表A.3班次列表查询请求内容描述及要求数据元编号公共请求信息包含公共请求内容M起点站代码JT/T979.2—2015中M发车日期所需车票的日期JT/T979.2—2015中M到达站代码—JT/T979.2—2015中M注：M-必备。A.2.1.3返回内容班次列表查询返回内容定义见表A.4。表A.4班次列表查询返回内容描述及要求数据元编号公共返回信息包含公共返回内容—M班次代码汽车班次号JT/T979.2—2015中M班次所属线路班次所属运行线路JT/T979.2—2015中M发车时间 JT/T979.2—2015中M末班时间 JT/T979.2—2015中0M客车类型—JT/T979.2—2015中5.3.20M客车等级 JT/T979.2—2015中5.3.21M座位数班次的总乘客座位数JT/T979.2—2015中M余座数班次剩余可售座位数JT/T979.2—2015中M座位类型一辆车可能有不同的座位类等，票价不同JT/T979.2—2015中M全票价全票价格JT/T979.2—2015中M半票价半票价格JT/T979.2—2015中00学生票价学生票价格JT/T979.2—2015中10基准价物价局批准的最高限价JT/T979.2—2015中0JT/T979.1—2015表A.4(续)描述及要求数据元编号班次性质JT/T979.2—2015中0班次类型JT/T979.2—2015中M行驶时间从发车站行驶至到达站所需的时间JT/T979.2—2015中1M行驶里程发车站至到达站的千米数JT/T979.2—2015中20线路始发站名称JT/T979.2—2015中0线路终点站名称JT/T979.2—2015中0注：M-必备，0-可选。下同A.2.2班次详情查询A.2.2.1语法格式A.2.2.2请求内容查询班次请求内容如表A.5所示。表A.5班次查询请求内容描述及要求数据元编号公共请求信息包含公共请求内容M班次代码汽车班次号JT/T979.2—2015中M起点站代码—JT/T979.2—2015中M发车日期所需车票的日期YYYYMMDDJT/T979.2—2015中M发车时间班次发车时间hhmmJT/T979.2—2015中M到达站代码JT/T979.2—2015中MA.2.2.3返回内容班次详情查询返回内容见表A.6。表A.6描述及要求数据元编号公共返回信息包含公共返回内容M班次类型 JT/T979.2—2015中M行驶里程从始发站到终点站的千米数JT/T979.2—2015中20行驶时间从发车站行驶至到达站所需的时间JT/T979.2—2015中10途经站点名称列表分号隔开，但不以分号结束。如：站点1;站点2;站点3—0余座数班次剩余可售座位数JT/T979.2—2015中MJT/T979.1—2015A.2.3锁定票源A.2.3.1语法格式A.2.3.2请求内容锁定票源请求内容见表A.7。表A.7锁定票源请求内容描述及要求数据元编号公共请求信息包含公共请求内容 M班次代码汽车班次号JT/T979.2—2015中M发车日期所需车票的日期YYYYMMDDJT/T979.2—2015中M发车时间班次发车时间hhmmJT/T979.2—2015中M起点站代码JT/T979.2—2015中M到达站代码—JT/T979.2—2015中M售票方式JT/T979.2—2015中9M锁座位信息列表此属性为集合，具体内容见表A.8—M锁定票源明细属性见表A.8。表A.8锁定票源明细属性描述及要求数据元编号车票类型JT/T979.2—2015中M座位号要锁定的座位号，为空表示不指定座位号JT/T979.2—2015中00车票价格 JT/T979.2—2015中M座位类型下铺、普通座、商务座等，票价不同JT/T979.2—2015中M姓名JT/T697.7—2014中.1M身份证件类别JT/T979.2—2015中6M身份证件号码 JT/T697.7—2014中.5M移动电话—JT/T697.7—2014中.27MA.2.3.3返回内容锁定票源接收文体见表A.9。表A.9锁定票源接收文体描述及要求数据元编号公共返回信息包含公共返回内容M订单号唯一标识一个订单JT/T979.2—2015中MJT/T979.1—2015表A.9(续)描述及要求数据元编号锁定数量—M锁定时长单位为秒(s)一M已锁座位信息列表此属性为集合，具体内容见表A.10—M已锁定票源明细属性如表A.10所示。表A.10描述及要求数据元编号车票类型JT/T979.2—2015中M座位号要锁定的座位号，为空表示不指定座位号JT/T979.2—2015中00车票价格JT/T979.2—2015中M座位类型一辆车可能有不同的座位类型，如上铺、下铺、普通座、商务座等，票价不同JT/T979.2—2015中M姓名 JT/T697.7—2014中.1M身份证件类别—JT/T979.2—2015中6M身份证件号码 JT/T697.7—2014中.5M移动电话JT/T697.7—2014中.27MA.2.4解锁票源A.2.4.1语法格式A.2.4.2请求内容解锁票源请求内容见表A.11。表A.11解锁票源请求内容描述及要求数据元编号公共请求信息包含公共请求内容M订单号唯一标识一个订单JT/T979.2—2015中M起点站代码 JT/T979.2—2015中M解锁票源号列表逗号分隔，如：1,2,3。传空表示解锁整个订单M20JT/T979.1—2015A.2.4.3返回内容表A.12解锁票源返回内容描述及要求数据元编号公共返回信息包含公共返回内容MA.2.5售票交易A.2.5.1语法格式A.2.5.2请求内容描述及要求数据元编号公共请求信息包含公共请求内容M订单号唯一标识一个订单JT/T979.2—2015中M起点站代码JT/T979.2—2015中M车票票号售票时如果即时打印车票，需要传入起始票号JT/T979.2—2015中0发票代码JT/T979.2—2015中0A.2.5.3返回内容售票返回内容定义如表A.14所示。描述及要求数据元编号公共返回信息包含公共请求内容M班次代码汽车班次号JT/T979.2—2015中M发车日期所需车票的日期YYYYMMDDJT/T979.2—2015中M发车时间班次发车时间hhmmJT/T979.2—2015中M发车站名称JT/T979.2—2015中M到达站名称JT/T979.2—2015中M客车类型取值见数据元值域JT/T979.2—2015中5.3.20M班次性质JT/T979.2—2015中M班次类型取值见数据元值域JT/T979.2—2015中M承运车辆牌号JT/T979.2—2015中0检票口班次上车检票口—021JT/T979.1—2015表A.14(续)描述及要求数据元编号行驶时间从发车站行驶至到达站所需的时间JT/T979.2—2015中10行驶里程发车站至到达站的千米数JT/T979.2—2015中20售票单位名称—JT/T979.2—2015中1M售出车票信息列表此属性为集合，具体内容见表A.15M售出座位明细属性见表A.15。描述及要求数据元编号电子票号用于唯一标识一张联网车票JT/T979.2—2015中0车票类型JT/T979.2—2015中M座位号售出的座位号JT/T979.2—2015中00车票价格 JT/T979.2—2015中M车票票号车票打印票号，电子票时为空JT/T979.2—2015中M发票代码 JT/T979.2—2015中M座位类型辆车可能有不同的座位类型，如上铺下铺、普通座、商务座等，票价不同JT/T979.2—2015中M基准价JT/T979.2—2015中0姓名 JT/T697.7—2014中.1M身份证件类别—JT/T979.2—2015中6M身份证件号码一JT/T697.7—2014中.5M移动电话JT/T697.7—2014中.27MA.2.6.1语法格式A.2.6.2请求内容退票查询请求内容定义见表A.16。表A.16退票查询请求内容描述及要求数据元编号公共请求信息包含公共请求内容M订单号唯一标识一个订单JT/T979.2—2015中M电子票号用于唯一标识一张联网车票JT/T979.2—2015中0起点站代码JT/T979.2—2015中M22JT/T979.1—2015A.2.6.3返回内容退票查询返回内容定义见表A.17。表A.17退票查询返回内容描述及要求数据元编号公共返回信息包含公共请求内容M班次代码汽车班次号JT/T979.2—2015中M发车日期所需车票的日期YYYYMMDDJT/T979.2—2015中M发车时间班次发车时间hhmmJT/T979.2—2015中M发车站名称JT/T979.2—2015中M到达站名称—JT/T979.2—-2015中M电子票号用于唯一标识一张联网车票JT/T979.2—2015中0座位号JT/T979.2—2015中00车票类型—JT/T979.2—2015中M车票状态JT/T979.2—2015中2M车票价格JT/T979.2—2015中M退票手续费率JT/T979.2—2015中0退票手续费JT/T979.2—2015中M车票票号JT/T979.2—2015中0发票代码JT/T979.2—2015中0售票时间—JT/T979.2—2015中0M操作人员代码JT/T979.2—2015中20退票描述信息车站退票的信息MA.2.7.1语法格式A.2.7.2请求内容退票交易请求内容定义见表A.18。表A.18退票交易请求内容描述及要求数据元编号公共请求信息包含公共请求内容—M订单号唯一标识一个订单JT/T979.2—2015中M电子票号用于唯一标识一张联网车票JT/T979.2—2015中0车票票号原车票票号JT/T979.2—2015中0起点站代码JT/T979.2—2015中M退票手续费—JT/T979.2—2015中M23JT/T979.1—2015A.2.7.3返回内容退票交易返回内容定义见表A.19。表A.19退票交易返回内容描述及要求数据元编号公共返回信息包含公共请求内容MA.2.8销票查询A.2.8.1语法格式A.2.8.2请求内容销票查询请求内容定义见表A.20。销票查询请求内容描述及要求数据元编号公共请求信息包含公共请求内容M订单号唯一标识一个订单JT/T979.2—2015中M电子票号用于唯一标识一张联网车票JT/T979.2—2015中0起点站代码JT/T979.2—2015中MA.2.8.3返回内容销票查询返回内容定义见表A.21。描述及要求数据元编号公共返回信息包含公共请求内容M班次代码汽车班次号JT/T979.2—2015中M发车日期所需车票的日期YYYYMMDDJT/T979.2—2015中M发车时间班次发车时间hhmmJT/T979.2—2015中M发车站名称—JT/T979.2—2015中M到达站名称—JT/T979.2—2015中M座位号 JT/T979.2—2015中00车票类型全、半、特JT/T979.2—2015中M车票状态JT/T979.2—2015中2M车票价格—JT/T979.2—2015中M车票票号—JT/T979.2—2015中0发票代码—JT/T979.2—2015中M售票时间YYYYMMDDhhmmJT/T979.2—2015中0M操作人员代码具体经办售票交易的操作人工号或柜员代码JT/T979.2—2015中2024JT/T979.1—2015A.2.9销票交易A.2.9.1语法格式A.2.9.2请求内容销票交易请求内容定义见表A.22。销票交易请求内容描述及要求数据元编号公共请求信息包含公共请求内容—M订单号唯一标识一个订单JT/T979.2—2015中M电子票号用于唯一标识一张联网车票JT/T