联网售票接口文档1(1)

汽车票务网系统接口协议说明书

富临运业-信息产业项目组

2014年12月

文档履历

目录

1.说明 (5)

2.接口形式 (5)

2.1.调用方式 (5)

2.2.返回结果 (5)

3.通用参数说明 (6)

3.1.公共输入参数 (6)

3.2.公共输出参数 (6)

4.接口实现列表 (6)

4.1.票务服务接口 (6)

4.1.1.余票查询 (6)

4.1.2.锁定座位接口 (8)

4.1.3.解锁座位接口 (9)

4.1.4.售票接口 (10)

4.1.5.车票查询接口 (11)

4.1.6.退票接口 (13)

4.1.7.废票接口 (14)

4.1.8.重打印接口 (15)

4.1.9.取票接口 (16)

4.2.数据同步接口（下行） (19)

4.2.1.汽车客运站信息同步 (19)

4.2.2.地域行政档案信息 (21)

4.2.3.站点信息同步 (22)

4.3.数据同步接口（上行） (23)

4.3.1.途经站点信息同步 (23)

4.3.2.客运班车基本信息同步 (24)

4.3.3.运行线路信息同步 (26)

4.3.4.运行线路班次信息同步 (27)

4.3.5.发班计划信息同步接 (29)

4.3.6.线路发班售票数据同步 (30)

4.4.行业监管数据采集接口 (31)

4.4.1.车站运力监控数据 (31)

4.4.2.安全生产监控数据 (32)

4.4.3.服务水平监控数据 (33)

4.5.数据同步接口（统一票务接口） (34)

4.5.1.联网机构同步 (34)

4.5.2.站点信息同步 (35)

4.5.3.班次计划同步 (35)

4.5.4.电子票信息同步 (36)

4.5.5.班次计划删除同步 (37)

4.5.6.车辆信息同步 (38)

4.5.7.发班运量同步 (39)

4.6.业务服务接口（统一票务接口） (39)

4.5.7.余票查询 (39)

4.6.2.锁定 (40)

4.6.3.解锁 (41)

4.6.4.售票 (42)

4.6.5.订单查询 (42)

4.6.7.废票 (44)

4.6.8.改签 (45)

4.5.9.取票 (45)

4.6.10.换票号重打印车票 (46)

4.6.11.取票查询 (47)

1.说明

提供汽车票务网系统统一对外渠道标准化接口。

2.接口形式

2.1.调用方式

通过http方式请求以下url: http://server_url?cmd&…

server_url：接口服务地址；

cmd：详见后面实现列表中的各个接口名;

…其它参数：根据后面各实现列表中各接口要求的私有参数进行设置。

2.2.返回结果

返回值均以json格式返回，格式如下：

{"code":"0","msg":"成功",”body”:”“}

code：状态码，0表示成功，其它的都为失败；每个接口都会返回；

msg：状态描述；每个接口都会返回。

body: 内容不固定，JSON格式，当code为0时body才可能有具体的返回字段，具体返回字段含义见4接口实现列表中返回参数说明。

3.通用参数说明

3.1.公共输入参数

3.2.公共输出参数

4.接口实现列表

4.1.票务服务接口

4.1.1.余票查询

1.功能说明

根据班次信息等条件查询该班次的余票信息。

2.接口名

cmd: getRemainingTicket

3.接口参数

4.返回结果

注：无。

4.1.2.锁定座位接口

5.功能说明

根据班次信息和座位数量信息锁定班次座位，锁票成功后，如未在锁定座位保留时间内完成售票操作，系统将自动解锁。

6.接口名

cmd: lockSeat

7.接口参数

8.返回结果

注：无。

4.1.3.解锁座位接口9.功能说明

根据订单号解锁已锁定的座位。

10.接口名

cmd: unlockSeat

11.接口参数

12.返回结果

注：根据班次ID+联网售票订单号向车站站务发起解锁当前订单号下面的车票信息。

4.1.4.售票接口

13.功能说明

根据订单号将已锁座位售出。

14.接口名

cmd: sellTicket

15.接口参数

16.返回结果

注：此接口根据订单售票，售票成功后返回车票列表信息，用于联网售票系统本地查询时用。

4.1.

5.车票查询接口

17.功能说明

根据输入的订单号或票号查询订单或票相关信息。

18.接口名

cmd: 19.接口参数

20.返回结果

注：根据订单号查询出站务系统此单下的车票信息。

4.1.6.退票接口

21.功能说明

根据车票信息进行退票。

22.接口名

cmd: refundTicket

23.接口参数

24.返回结果

注：直接返回是否退款成功即可。

4.1.7.废票接口

25.功能说明

将售出票进行作废处理。

26.接口名

cmd: invalidTicket

27.接口参数

28.返回结果

注：由站务系统处理作废逻辑返回作废是否成功即可。

4.1.8.重打印接口29.功能说明

重新打印电子客票已取的车票。

30.接口名

cmd: againPrint

31.接口参数

32.返回结果

33.

注：无。

4.1.9.取票接口

34.功能说明

重新打印电子客票已取的车票。

35.接口名

cmd: collectTicket

36.接口参数

37.返回结果

注：无。

4.1.10.订单信息查询38.功能说明

查询网上购票订单信息。39.接口名

cmd:

40.接口参数

41.返回结果

注：无。

4.2.数据同步接口（下行）

4.2.1.汽车客运站信息同步

42.功能说明

从联网售票数据中心及省级道路客运数据中心同步客运站信息。

43.接口名

cmd: getStationInfo

44.接口参数

45.返回结果