文档中心 > 综合交通-商家对接

境外火车票API对接

更新时间:2020/05/22 访问次数:2683

主要包含商品接口以及交易接口
top接口:代理商request,飞猪response。飞猪实现的接口,代理商可请求top接口,获得飞猪提供的数据。
奇门接口:飞猪request,代理商response。飞猪提供接口定义,代理商负责接口实现,飞猪请求接口获得代理商的数据。
接口地址

一、奇门接口

商品接口

qimen.alitrip.rail.ir.search( 国际火车票搜索接口 )

猪平台查询代理商路线方案数据,即搜索接口,代理商返回一系列路线方案,其中包含承运公司、车站、仓位、票种等code信息,飞猪平台根据这些code关联详细信息后,提供给用户选择。接口支持同步和异步两种方式,同步的时候飞猪平台request,代理商返回方案列表;异步的时候飞猪平台第一次request,代理商返回一个async_key作为下次轮询的唯一标志,飞猪平台用这个key再次持续轮询代理商接口直到拿到车次方案且hasMore=fasle。

qimen.alitrip.rail.ir.schedule.get( 查询代理商时刻表信息 )

飞猪平台查询代理商车次时刻表信息,根据车次号train.number和承运公司carrie_code查询列车时刻表信息。

qimen.alitrip.rail.ir.offers.get( 查询代理商票种数据 )

飞猪平台查询代理商的票种数据,代理商的全部票种信息应该全部准备好,飞猪平台会每天1次定时任务拉取数据写入飞猪数据库。

qimen.alitrip.rail.ir.service.get( 查询代理商仓位数据 )

飞猪平台查询代理商的仓位数据,代理商的全部仓位信息应该全部准备好,飞猪平台会每天1次定时任务拉取数据写入飞猪数据库。

交易接口

qimen.alitrip.rail.trade.book(预订占座、占座接口 )

占座接口,用户在平台搜索路线后,确认某个具体路线占击预订时触发占座接口。占座接口超时时间为20S,20S之内会轮询占座结果,超过20S后平台直接占座失败,用户下单失败。接口返回值如果是异步的,需要返回isAsync=true且asyncKey不为空,如果不是异步的必须返回agentOrderId(商家订单号),其他字段非必须。

qimen.alitrip.rail.trade.querybook( 占座结果确认 )

占座确认接口,考虑到有些代理商book是异步的,在book时会返回异步key,平台用异步key轮询占座结果。同时为了兼容book是同步接口,在网络异常情况下,会用agentOrderId再次查询确认book是否成功。同步接口返回成功即可。PaymentPrice,chargeFee,agentOrderId必填项,其他字段非必须。

qimen.alitrip.rail.trade.confirm( 行程确认接口 )

行程确认接口,占座成功后,用户在平台支付成功,平台用商家订单号通知商家出票。接口也有同步异步之分

qimen.alitrip.rail.trade.queryconfirm( 行程确认轮询接口 )

行程确认接口,考虑到有些代理商confirm是异步的,在confirm时会返回异步key,平台用异步key轮询出票接口。
success返回成功,module为空的默认表示出票中,平台继续轮询,success成功,module不空表示出票成功,平台转交易成功,商家可以在淘宝后台看到订单成功。queryconfirm接口超时时间20分钟,之后订单会关闭退款给用户,可能产生资损。如果票类型是pnr取票号,需要返回这个号,其他可不返回,同时如果票需要2次确认的话,需要返回confirm_again为true,平台会等待商家回调出票成功。如果票在搜索时就告诉平台需要2次确认,订单超时时间是10小时,如果在搜索时没有告知,在此接口告知是2次确认,订单超时时间是40分钟。

qimen.alitrip.rail.trade.queryorder( 境外火车票订单查询 )

订单状态查询接口,主要做审计用。由于有接口超时及网络等各种原因导致订单被关闭,需要审计平台与商家订单状态一致性,有审计报警时,平台会联系商家确认订单状态,减小资损的产生。

qimen.alitrip.rail.trade.downloadticket( 车票下载 )

queryconfirm后平台继续下载车票。返回车票url链接,平台会下载后保存。

qimen.alitrip.rail.trade.refundapply( 退票申请接口 )

出票成功后,用户在平台申请退票,平台通过此告知商家去退票。

二、top接口

商品接口

alitrip.rail.ir.division.get( 代理商查询标准城市 )

代理商查询飞猪平台标准境外城市数据,包括除中国大陆以外的全部地区的城市数据。在飞猪发起对代理商系统查询路线方案(qimen.alitrip.rail.ir.search)的时候,入参中的出发、到达城市就来自于这些标准城市,所以代理商需要拿到这些城市数据后,在自己的系统中对自有的城市数据做标准映射。
比如飞猪标准城市慕尼黑(902347)、法兰克福(902344),会在qimen.alitrip.rail.ir.search时传入902347到902344代表要search慕尼黑到法兰克福的的路线。

alitrip.rail.ir.station.get( 代理商查询标准车站 )

代理商查询飞猪平台标准境外车站数据,同“代理商查询标准城市”接口类似,在飞猪发起对代理商系统查询路线方案(qimen.alitrip.rail.ir.search)的时候入参中的出发、到达车站就来自于这些标准车站,在search返回的数据中,车站信息也必须是标准的车站信息。所以代理商需要拿到这些车站数据后,在自己的系统中对自有的车站数据做标准映射。如果代理商发现飞猪平台的标准车站数据不能覆盖自己的车站,请人工反馈给我们,我们确认审核后会新增这些车站为标准车站,代理商再次拉取数据后映射。

alitrip.rail.ir.carrier.get( 代理商查询铁路公司 )

代理商查询飞猪平台的铁路承运公司数据,同“代理商查询标准城市”接口类似….在search返回的数据中的carrire信息必须是飞猪平台的标准铁路承运公司。同样,如果发现飞猪平台的标准承运公司无法覆盖代理商的承运公司,请反馈,我们会确认审核新增,代理商再次拉取数据后映射。

交易接口

alitrip.rail.trade.issueticket( 德铁出票成功接口 )

需要2次确认的票出票成功后,商家回调平台成功

alitrip.rail.trade.closeticket( 出票失败关单接口 )

需要2次确认的票出票失败后,商家回调平台关单

alitrip.rail.trade.refund( 退票接口 )

退票成功/失败
商家退票成功后,通过此top接口回调平台告知退票结果。如果成功,平台给用户退钱,失败的话直接通知用户退票不失败。不要私下给用户退钱,统一走平台退款,闭环流程。

三、流程图

image

FAQ

关于此文档暂时还没有FAQ
返回
顶部