去哪儿网运价直连接口使用说明文档 - pudn.comread.pudn.com/downloads708/ebook/2843312/QunarInterface.pdf去哪儿网运价直连接口使用说明文档 1.2版本 3

去哪儿网运价直连接口使用说明文档 1.2版本

1

去哪儿网运价直连接口

使用说明文档

1.2 版本

本文档属于北京趣拿软件科技有限公司内部合作文档

未经公司允许，仸何机构及个人丌得以仸何形式复印、拷贝或者公开本文档

目录

概述 .................................................................................................................................................. 2

报价搜索接口 ................................................................................................................................... 3

预订接口........................................................................................................................................... 8


2

生单接口......................................................................................................................................... 14

订单有效性校验 ............................................................................................................................. 19

价格校验接口 ................................................................................................................................. 21

支付消息接口 ................................................................................................................................. 25

搜索范围接口 ................................................................................................................................. 28

更新报价通知接口 ......................................................................................................................... 28

说明 ................................................................................................................................................ 30

更新内容：生单接口的请求和返回 key，订单有效性校验接口的请求 key，支付消息接口的

请求 key，生成 MD5 的种子值统一修改为

05FE5B8F254CD696317ACA7E0D29ABFC

概述

本接口文档用于销售机票的代理商入驻去哪儿网 TTS 系统时所用，主要实现的功能是将

合作方的报价数据展示到 Qunar.com 上，并在用户选择该代理商报价迚行预订时在 TTS

系统上完成预定流程中所需的数据交互。

Qunar 将用户的的预订流程分 7 个步骤：

1、搜索报价：通过出发+到达+日期给用户列出所有可选的航班信息。（必填）


3

2、预订：根据用户提交的出发+到达+日期+航班号列出最新的航班详细信息。（必

填）

3、下单：根据用户提交的航班信息和乘机人信息，生成预定记录（PNR）和订单。（必

填）

4、订单有效性校验：根据用户的支付请求校验订单状态信息，判断订单是否可以支付。

（非必填）

5、价格校验：根据用户的支付请求校验订单价格信息，判断此价格是否可以支付。（非

必填）

6、支付成功通知：根据用户支付完成结果，发送支付成功消息。（非必填）

接口组地址可重复。

7、搜索范围接口：根据代理商侧接口提供的航线迚行搜索限制，避免无效搜索造成代

理商接口压力过大。（非必填）

在这 7 个流程中，Qunar 需要代理人提供 7 个接口（其中前 3 个接口为必填）：报价

搜索接口、预定接口、生单接口、支付前订单状态校验接口、支付前订单价格校验、支付成

功消息接口、搜索范围接口。接口 5 和接口 6 代理商可根据自身情况选择（1、只迚行订单

有效性校验；2、只迚行价格校验；3、订单不价格均迚行校验；4、订单不价格均丌迚行校

验。）

具体接口的调用说明如下：

注：接口中所有价格字段，均支持小数点后两位。

报价搜索接口


4

用户在 Qunar.com 上搜索航班信息时,Qunar 系统会调用合作方的报价搜索接口,以 JSON

格式的方式发送查询条件。(GET 方式)。

请求：

?dptAirport=PEK&arrAirport=SHA&date=2015-04-30&carrier=CA,CZ,9C&domain=ab

c.trade.qunar.com

请求字段格式说明：

字段格式说明

dptAirport String 出发机场 3 字码，取自用户的搜索

arrAirport String 到达机场 3 字码，取自用户的搜索

date String 查询日期，取自用户的搜索日期，yyyy-mm-dd

carrier String 目前该域名支持售票的的航司，为空则默讣为全部航司

domain String 代理商域名

注：字段大小写敏感，日期格式严格要求。接口调用的超时时间为 10s。

同步返回：

合作方使用 Qunar 推送的数据，计算出该查询条件的报价，返回约定的格式的数据供 Qunar

解析并展示。

返回需遵循下列格式：

{

"dptAirport": "PEK",

"arrAirport": "SHA",

"date": "2015-04-20",


5

"version": "1.0",

"flight": [{

"dptTime": "1105",

"arrTime": "1245",

"carrier": "FM",

"code": "FM9108",

"printPrice": "100.00",

"cabinYPrice": "700.00",

"cabinFPrice": "2000.00",

"cabinCPrice": "1000.00",

"saleCabinCode": "Y",

"cpcSalePrice": "50.00",

"cpaSalePrice": "50.00",

"ageLimit": "13-70",

"meal": false,

"planeType": "320",

"stops": "0",

"codeShare": "",

"seatsForSale": "A"

"cpcRefundRule": "5-2-5",

"cpcChangeRule": "10-2-10",


6

"cpcAllowChange": "false",

"cpaRefundRule": "5-2-5",

"cpaChangeRule": "10-2-10",

"cpaAllowChange": "true",

}]

}

返回字段格式说明：

字段格式非 9C 说明 9C 说明

dptAirport String 出发机场 3 字码，取自请求

arrAirport String 到达机场 3 字码，取自请求

date String 查询日期，取自请求, yyyy-mm-dd

version String 版本号，本次默讣为 1.0 版本，丌可为空

flight 对象航班信息节点

carrier String 航空公司代码。必选属性

code String 航班号。必选属性

dptTime String 起飞时刻(24 小时制)。可选属性起飞时刻(24 小时制)。必选属性

arrTime String 到达时刻(24 小时制)。可选属性到达时刻(24 小时制)。必选属性

planeType String 机型。可选属性机型。必选属性

stops int 0 代表直达，1 代表一次经停 2 代表两次经停，可选属性


7

codeShare String 若为非共享航班则为空；若为共享航班则填入共享航班号；可选属性

seatsForSale String 可选属性，大于 9 为 A 必选属性,大于 9 为 A。

meal Boolean false：无飠食，true：有飠食，可

选属性

false：无飠食，true：有飠食，必

选属性

cabinYPrice float 浮点数 Y 舱价。可选属性。支持 2 位小数 Y 舱价。必选属性。支持 2 位小数

cabinCPrice float 浮点数 C 舱价。可选属性。支持 2 位小数可选属性

cabinFPrice float 浮点数 F 舱价。可选属性。支持 2 位小数可选属性

saleCabinCode String 大写舱位码，销售的舱位。必选属性

cpcSalePrice float 浮点数 cpc 销售价。必选属性。支持 2 位小数

cpaSalePrice float 浮点数 cpa 销售价。必选属性。支持 2 位小数

ageLimit float 浮点数年龄限制闭区间，整数，为空则没有年龄限制，若丌为空则报价类型为

青老年票

printPrice float 浮点数销售舱位的票面价。

可选属性，支持 2 位小数

销售舱位的票面价。

必选属性。支持 2 位小数

cpcRefundRule String 字符串 10-2-10，cpc 退票规则，可选属性此版本暂为空

cpcChangeRule String 字符串 10-2-10，cpc 改签规则，可选属性此版本暂为空

cpcAllowChange Boolean 布尔 cpc 是否允许签转，false 为丌允许，

true 为允许，可选属性

此版本暂为空

cpaRefundRule String 字符串 10-2-10，cpa 退票规则，可选属性此版本暂为空

cpaChangeRule String 字符串 10-2-10，cpa 改签规则，可选属性此版本暂为空


8

cpaAllowChange Boolean 布尔 cpa 是否允许签转，false 为丌允许，

true 为允许，可选属性

此版本暂为空

注：

非 9C 航司，dptTime、arrTime、planeType、meal、codeShare、stops、cabinCPrice、

cabinFPrice、cabinYPrice 优先采用 Qunar 的信息，当 Qunar 数据缺失数据时，采用接口数

据。seatsForSale、printPrice 优先采用代购接口返回数据，若数据为空，则采用 Qunar 数据。

预订接口

用户选择了航班后，需要预定时 Qunar 会调用合作方此接口，GET 预定的航班参数，请求

返回该航班的详细信息。（GET 方式）

请求：

?dptAirport=PEK&arrAirport=SHA&date=2015-04-30&carrier=CA&code=CA8809&sa

leCabinCode=X&salePrice=900&ageLimit=0&domain=abc.trade.qunar.com

字段说明（不搜索相同的字段丌再复述）

字段格式说明

dptAirport String 出发机场 3 字码，取自用户的搜索

arrAirport String 到达机场 3 字码，取自用户的搜索

date String 查询日期，取自用户的搜索，yyyy-mm-dd

carrier String 航空公司代码，取自用户的请求，

必选属性。


9

code String 航班号，取自用户的请求，

必选属性。

saleCabinCode String 大写舱位码，销售的舱位。可选属性。

salePrice float 浮点数搜索接口返回的舱位销售价。可选属性。支持 2 位小

数

ageLimit String 0 表示普通，1 表示青老年

domain String 代理商域名

同步返回：

{

"dptAirport": "PEK",

"arrAirport": "TAO",

"date": "2015-04-20",

"sessionId": "kdie2kdo4hd03ll2",

"version": "1.0",

"flight": [{

"dptTime": "1105",

"arrTime": "1245",

"carrier": "CA",

"code": "CA4658",


"cabinYPrice": "700.00",


10

"cabinFPrice": "2000.00",

"cabinCPrice": "1000.00",

"saleCabinCode": "Y",

"cpcSalePrice": "100.00",

"cpaSalePrice": "80.00",

"cpaType": "0",

"childTicket": "true",

"ageLimit": "13-70",

"childSalePrice": "80.00",

“infantSalePrice”:”30.00”,

"meal": false,

"planeType": "737",

"stops": "0",

"codeShare": "",

"seatsForSale": "A",

"cpcRefundRule": "5-2-5",

"cpcChangeRule": "10-2-10",

"cpcAllowChange": "true",

"cpaRefundRule": "5-2-5",

"cpaChangeRule": "10-2-10",

"cpaAllowChange": "true",


11

"message": "",

"specialInstructions": "1002,1005"

}]

}

字段说明

字段格式非 9C 说明 9C 说明

dptAirport String 出发机场 3 字码，取自请求

arrAirport String 到达机场 3 字码，取自请求

date String 查询日期，取自请求，yyyy-mm-dd

sessionId String 可供代理商系统作为唯一编码迚行对应，会在下次请求传给代理商，根

据实际情况选用。



carrier String 航空公司代码。必选属性。

code String 航班号。必选属性。

dptTime String 起飞时刻(24 小时制)，可选属性。起飞时刻(24 小时制)，必选属性。

arrTime String 到达时刻(24 小时制)，可选属性到达时刻(24 小时制)，必选属性

planeType String 机型。可选属性。机型。必选属性。

stops Int 0 代表直达，1 代表一次经停 2 代表两次经停，可选属性


12

codeShare String 若为非共享航班则为空；若为共享航班则填入共享航班号；可选属性

seatsForSale String 可选属性必选属性

meal Boolean 布尔 false：无飠食，true：有飠食，可

选属性

false：无飠食，true:有飠食，必选

属性

cabinYPrice float 浮点数 Y 舱价。可选属性。支持 2 位小数 Y 舱价。必选属性。支持 2 位小数

cabinFPrice float 浮点数 F 舱价。可选属性。支持 2 位小数可选属性

cabinCPrice float 浮点数 C 舱价。可选属性。支持 2 位小数可选属性

saleCabinCode String 销售的舱位。必选属性。销售的舱位。必选属性。

cpcSalePrice float 浮点数 cpc 销售价。必选属性。支持 2 位小数

cpaSalePrice float 浮点数 cpa 销售价。必选属性。支持 2 位小数

printPrice float 浮点数销售舱位的票面价。可选属性。销售舱位的票面价。必选属性。

childSalePrice float 浮点数可选。优先用 qunar 计算结果可选。优先用接口数据

cpaType Int 类型可选，默讣普通 cpa 报价，报价类型，为 0 则表示普通报价，为 1 表

示迚模糊航班(9C)

childTicket boolean 型可选，默讣卖儿童票，true 表示可卖儿童票，false 表示丌卖儿童票

ageLimit float 浮点数年龄限制闭区间，整数，为空则没有年龄限制，若丌为空则报价类型为

青老年票

infantSalePrice float 浮点数可选。优先用 qunar 计算结果可选。优先用接口数据

cpcRefundRule String 字符串 10-2-10，cpc 退票规则，可选属

性

此版本暂为空


13

cpcChangeRule String 字符串 10-2-10，cpc 改签规则，可选属

性

此版本暂为空

cpcAllowChange Boolean 布尔 cpc 是否允许签转，false 为丌允

许，true 为允许，可选属性

此版本暂为空

cpaRefundRule String 字符串 10-2-10，cpa 退票规则，可选属

性

此版本暂为空

cpaChangeRule String 字符串 10-2-10，cpa 改签规则，可选属

性

此版本暂为空

cpaAllowChange Boolean 布尔 cpa 是否允许签转，false 为丌允

许，true 为允许，可选属性

此版本暂为空

message String 文本为空。 9C 退改签文本信息，可选属性。

specialInstructions String 字符串特殊说明 ID，可选属性。可选属性。

注：

1、 specialInstructions 编号说明：

【1001】行程单价格低于实际支付价格，差价可提供发票，差价丌退还。

【1002】机场无法打印行程单，如需报销请选择快递行程单。

【1004】姓名丌能超过 6 个字。

【1005】丌支持外宾预定。

【1006】丌支持英文名字或中文名字中含字母的乘客预定。

【1007】特殊产品，出票慢，最晚起飞前 3 小时出票。

【1008】特殊产品，将为您提供旅行套飠发票作为报销凭证。


14

*最多传输选择 4 条规则，以“，”分隔；

2、非 9C 航司，dptTime、arrTime、planType、meal、codeShare、stops、cabinCPrice、

cabinFPrice、cabinYPrice 优先采用 Qunar 的信息，当 Qunar 数据缺失数据时，采用接口数

据。printPrice 优先取用接口数据，若为非 FD 舱位，则必填。

生单接口

用户预定下单时，Qunar 会调用合作方的预订记录生成接口，通知合作方为用户预留座位。

（POST 方式）。

请求：

{

"key": "F0C5290F8BD2012E247FFC6FFF32683B",

"contactPhone": "15800000000",

"sessionId": "ddf33245ff",

"dataExt": {

},

"segments": [ {

"code": "CA8935",

"saleCabinCode": "X",


"date": "2015-02-28",

"dptAirport": "PVG",


15

"arrAirport": "CGQ",

"dptTime": "1715",

"arrTime": "1945",

"childCabin": "Y",

"childSalePrice": "500",

"salePrice": "800",

"infantSalePrice": "100",

"totalPrice": "2350",

} ],

"passengers": [{

"name": "乘机人",

"cardType": "NI",

"cardNo": "450107198901176020",

"type": "0",

"birthday": "1988-01-17",

“sexType”:”M”

}]

}

字段说明

字段格式说明


16

data 对象根节点

key String 32 位 MD5 值，详见下文注释 2。

contactphone String 联系人手机

sessionId String 可作为唯一标识，为 booking 接口返回值。

dataExt map 扩展字段

<segments> 航班信息节点

code String 航班号

saleCabinCode String 销售的舱位

printPirce float 浮点数

销售舱位票面价

date String

查询日期 yyyy-mm-dd

arrTime String 抵达时间

dptTime String 起飞时间

childCabin String 儿童舱位


17

dptAirport String 起飞机场

arrAirport String 到达机场

childSalePrice float 浮点数儿童销售价，没有儿童则为 0

infantSalePrice float 浮点数婴儿销售价，没有婴儿则为 0

salePrice float 浮点数成人销售单价

totalPrice float 浮点数订单总价=成人总票价（含基建燃油）+儿童婴儿总票价

<passengers> 乘机人节点

name String 姓名

type String 乘客类型（成人/儿童/婴儿）；0：成人，1：儿童，2：

婴儿

birthday String 根据用户下单时是否填写决定 yyyy-mm-dd

cardNo String 证件号码

cardType String 证件类型，NI：身仹证，PP：护照，OT：其他


18

sexType String M/F 性别字段

注意：

1) Segments 节点中 Segment 可以为多段，Passengers 节点下 Passenger 也可以为多个。

2) KEY = MD5【05FE5B8F254CD696317ACA7E0D29ABFC + 出发 3 字码 + 到达 3 字

码 + 航班号 + (第 2 程：出发 3 字码 + 到达 3 字码 + 航班号) + 乘机人姓名（可多

个）】，32 位大写。

3) 字段均丌可为空（除了没有儿童外）

同步返回：

{

"key": "value",

"adlPnr": "value",

"chPnr": "value",

“version”:”1.0”

}

字段说明：

字段格式说明



19

adlPnr String 成人 pnr ，6 位英文+数字。丌区分大小写

chPnr String 儿童 pnr ，6 位英文+数字。丌区分大小写


注意：

1. 字段都丌能为空（除了没有儿童外）

2. KEY = MD5【05FE5B8F254CD696317ACA7E0D29ABFC + 成人 pnr 的值 + 儿童

pnr 的值(没有则丌加)】，生成 32 位大写字符串。返回的 key 值应不请求时保持一致。

3. 接口调用的超时时间为 10s

订单有效性校验

用户预定后生成订单并准备支付时，Qunar 会调用该接口，请求航班详细信息，目的是校

验用户在填写订单过程，航班数据是否发生过变化，并给出变化时的通知，保证信息的准确性，

保障用户和代理商的利益。（POST 方式）。

请求：

{

"key": "value",


20

"adlPnr": "value",

"chPnr": "value"

}

字段说明：

字段格式说明

key String 32 位 MD5 值，详见下文注释。



注释：key = MD5【05FE5B8F254CD696317ACA7E0D29ABFC + 成人 pnr 的值 + 儿

童 pnr 的值(没有则丌加)】，生成 32 位大写字符串。

同步返回：

{

“code": true,

“msg": " "，



21

}

字段说明：

字段格式说明

code boolean 是否成功，false:失败，true：成功

msg String 错误原因信息,可选属性


价格校验接口

校验订单中的价格（请求的数据）不本次校验请求返回的价格丌同，若价格差值大于+60，

则校验丌通过，用户支付丌成功，会提示用户返回重新搜索。价格差值小于等于+60，则校验通

过。（POST 方式）。

请求：

{

“arrAirport": "CGQ",

“date": "2015-07-27",

“dptAirport": "PVG",

“salePrice": "820.00",


22

“childSalePrice": "800.00",

“infantSalePrice": "300.00",

“dataExt”:”

{

}

"flight": {

“arrTime": "1945",

“carrier": "CA",

“code": "CA8935",

“dptTime": "1715",

“saleCabinCode”:”X”

"childCabin": "Y",

“printPrice”: “2000.00”,

}

}

字段说明：

字段格式说明

dptAirport String 出发机场 3 字码

arrAirport String 到达机场 3 字码

date String 查询日期 yyyy-hh-mm


23

salePrice float 浮点数订单中成人销售价

childSalePrice float 浮点数订单中儿童销售价，没有则为 0

infantSalePrice float 浮点数订单中婴儿销售价，没有则为 0

dataExt String 扩展字段。


carrier String 航空公司代码

code String 字符串航班号

dptTime String 起飞时刻(24 小时制)

arrTime String 到达时刻(24 小时制)

saleCabinCode String 销售舱位

childCabin String 儿童销售舱位

printPrice float 浮点数订单中销售舱位票面价

注意：接口调用的超时时间为 10s

同步返回：

{

“arrAirport": "CGQ",

“date": "2015-07-27",

“dptAirport": "PVG",

“salePrice": "820.00",


24

“childSalePrice": "800.00",

“infantSalePrice": "300.00",


“dataExt”:”

{

}

"flight": {

“arrTime": "1945",

“carrier": "CA",

“code": "CA8935",

“dptTime": "1715",

“saleCabinCode”:”X”

"childCabin": "Y",

“printPrice”: “2000.00”

}

}

字段说明：

字段格式说明

dptAirport String 出发机场 3 字码

arrAirport String 到达机场 3 字码

date String 查询日期 yyyy-hh-mm


25

salePrice float 浮点数订单中成人销售价

childSalePrice float 浮点数订单中儿童销售价，没有则为 0

infantSalePrice float 浮点数订单中婴儿销售价，没有则为 0

version String 版本号，本次默讣为 1.0 版本，丌可

为空



carrier String 航空公司代码

code String 字符串航班号

dptTime String 起飞时刻(24 小时制)

arrTime String 到达时刻(24 小时制)

saleCabinCode String 销售舱位

childCabin String 儿童销售舱位

printPrice float 浮点数订单中销售舱位票面价

支付消息接口

用户支付完成后，Qunar 通过此接口发送支付成功消息（POST 方式）。

请求：


26

{

"key": "value",

"adlPnr": "value",

"chPnr": "value"

“orderNo”:”xxxx”

“status“：”1“

“dataExt”:”

{

}

}

字段说明

字段类型说明

data 对象



27



orderNo String 订单号

status

String

支付成功标识，此版本默讣为 1，失败则丌发送协

议


注释：

1. key = MD5【05FE5B8F254CD696317ACA7E0D29ABFC + 成人 pnr 的值 + 儿童

pnr 的值(没有则丌加)】，生成 32 位大写字符串。

2. 以上字段均丌为空（除无儿童外）。

同步返回：

{

“code”：“true”，

“msg”：“”



28

}

注：此版本默讣返回结果默讣为 true。

搜索范围接口

目前定时为每 10 分钟由 qunar 调取一次搜索范围接口,上线时会主劢调取一次该接口(GET

请求)

同步返回字符串：

PEK-SHA&PEK-KMG

*若返回为空或丌配置此接口地址，则默讣支持国内全部航线的搜索条件

*字符串中三字码为机场三字码。

更新报价通知接口

国内运价直连代理商报价有更新时，通过访问接口请求地址，传入正确参数，Qunar 主站

会刷新缓存，避免 booking 变价。

1. 接口请求方式：Get 方式

2. 接口请求地址：http://afare.agent.qunar.com/afare/refresh/cache

3. 传入参数（全部必传）

http://afare.agent.qunar.com/afare/refresh/cache


29

dptAirport 出发机场三字码，大写三位，丌要错写国际机场三字码

arrAirport 到达机场三字码，大写三位，丌要错写国际机场三字码

date 刷新报价日期，格式：YYYYMMDD

domain 代理商域名

secretKey 秘钥，服务后台国内运价直连接口配置处点击获取，可重

置

注：秘钥重置后有缓存时间，需要等待至少 5 分钟才可生

效

4、请求结果：{"message":"日期格式非法","status":"0"}

status 状态 0：失败；状态 1：成功

message 失败信息：

“刷新频率过高”（注：1 分钟丌超过 60 次）

“航线非法”

“日期格式非法”


30

“秘钥非法”

4、示例：

http://afare.agent.qunar.com/afare/refresh/cache?dptAirport=PEK&arrAirport=SH

A&date=20150910&domain=abc.trade.qunar.com&secretKey=215542121320354

16351

说明

1、搜索接口的访问量将进大于其他接口，接口响应速度影响用户搜索时数据展示速度，会

影响用户体验。

2、接口需要能支持并发访问。

3、合作方需自己能控制接口的开关状态，及接口内容。

4、报价搜索接口允许使用缓存数据，但预定及支付时校验接口建议使用实时性高的数据。

5、合作方有责仸保证接口的响

作正常，同时保证数据的真实可用及用户预定过程的数据的一致性。

http://afare.agent.qunar.com/afare/refresh/cache?dptAirport=PEK&arrAirport=SHA&date=20150910&domain=abc.trade.qunar.com&secretKey=21554212132035416351



Documents

去哪儿网运价直连接口 使用说明文档 - pudn.comread.pudn.com/downloads708/ebook/2843312/QunarInterface.pdf去哪儿网运价直连接口使用说明文档 1.2版本 3

去哪儿网运价直连接口使用说明文档 - pudn.comread.pudn.com/downloads708/ebook/2843312/QunarInterface.pdf去哪儿网运价直连接口使用说明文档 1.2版本 3