在线接口文档中心

在线接口文档中心

接口地址:

http://接口域名/flight/query

返回格式:

json

请求方法:

get

请求示例:

http://接口域名/flight/query?appKey=您申请的APPKEY&fromCityCode=KRL&toCityCode=CTU&fromDate=2020-06-10&sign=17fb3f159a93cf6a5d0275565d1a0954

接口说明:

此接口可以通过指定航线、航班、出发日期、航空公司等条件查询,查询结果包括航班数据、库存、票面价、机建税、燃油费、结算价、返点返现政策等 信息。

往返或联程查询通过两次单程查询实现即可!

请求参数:

参数名称

类型

必填

说明

fromCityCode

string

出发城市三字码或机场三字码

toCityCode

string

到达城市三字码或机场三字码

fromDate

string

出发日期(格式:yyyy-MM-dd 如:2020-10-01 )

cabinLevel

int

仓位类型(等级): 1=经济舱,2=公务舱,3=头等舱

airlineCode

string

航司二字代码,如: CZ (即南方航空)

flightNo

string

航班号,只查询指定航班号的航班

sign

string

签名校验值,md5(secretKey+fromCityCode+toCityCode+fromDate+secretKey) ,secretKey为请求密钥,开通账户时即可获得,加密结果转为32位小写 。【注意:加密前的拼接原串不包含'+'】

返回参数:

参数名称

类型

说明

voyage

voyageInfo

航程信息

fromCityCode

string

出发城市三字码

toCityCode

string

到达城市三字码

fromCityName

string

出发城市名称

toCityName

string

到达城市名称

fromDate

string

出发日期 格式:yyyy-MM-dd

flights

flightInfo[]

航程对应的航班信息

flightNo

string

航班号

airlineCompany

string

航空公司名称

airlineCode

string

航空公司二字码

airlineLogoUrl

string

航空公司 logo

fromAirportCode

string

出发机场三字码

toAirportCode

string

到达机场三字码

fromAirportName

string

出发机场名称

toAirportName

string

到达机场名称

isShareFlight

bool

是否为共享航班

realFlightNo

string

当为共享航班时,实际承运的航班号

fromDateTime

datetime

出发时间(格式:yyyy-MM-dd HH:mm:ss)

toDateTime

datetime

到达时间(格式:yyyy-MM-dd HH:mm:ss)

fromTerminal

string

出发航站楼,如:T1

toTerminal

string

到达航站楼,如:T2

flyDuration

string

飞行时长,格式HH:mm,如:03:05,表示飞行 3小时5分钟

adultTax

int

成人机建费

adultFuel

int

成人燃油税

childTax

int

儿童机建费

childFuel

int

儿童燃油税

babyTax

int

婴儿机建费

babyFuel

int

婴儿燃油税

stopNum

int

经停次数

craftType

string

机型,如:空客A320

meals

string

餐食情况(值:有餐食|无餐食)

cabins

cabinInfo[]

航班舱位列表

cabinCode

string

舱位代码

cabinLevel

int

国内机票舱位等级(经济舱 =1 ,公务舱 = 2, 头等舱=3)

cabinName

string

舱位名称

seatLeftNum

int

舱位剩余座位数 :1-10(备注:<10表示实际座位余数 10表示余票充足,泛指)

discount

double

折扣,如:0.29 表示29折

cabinBookPara

string

舱位下单参数,下单原样传入即可(备注:下单必传字段)

cabinPrice

CabinPriceInfo

舱位价格信息

adultFarePrice

int

成人票面价(即官网公布运价,行程单上的票面价)

adultSalePrice

float

成人销售价(不含税),即贵司在平台的采购价

childFarePrice

int

儿童票面价(一般为成人所选舱等的全价票的50%)

childSalePrice

float

儿童销售价(不含税)

babyFarePrice

int

婴儿票面价(一般为成人所选舱等的全价票的10%)

babySalePrice

float

婴儿销售价(不含税)

JSON返回示例 :

{

"data": {

"voyage": {

"fromCityCode": "KRL",

"toCityCode": "CTU",

"fromCityName": "库尔勒",

"toCityName": "成都",

"fromDate": "2020-06-10",

"flights": [

{

"flightNo": "CZ6925",

"airlineCompany": "南方航空",

"airlineCode": "CZ",

"airlineLogoUrl":"http://api.panhe.net/Content/Images/AirLineLogo/CZ.png",

"fromAirportCode": "KRL",

"toAirportCode": "CTU",

"fromAirportName": "库尔勒",

"toAirportName": "成都双流",

"isShareFlight": false,

"realFlightNo": null,

"fromDateTime": "2020-06-10 09:40:00",

"toDateTime": "2020-06-10 15:45:00",

"fromTerminal": "--",

"toTerminal": "T2",

"flyDuration": "06:05",

"adultTax": 50,

"adultFuel": 0,

"childTax": 0,

"childFuel": 0,

"babyTax": 0,

"babyFuel": 0,

"cabins": [

{

"cabinCode": "M",

"cabinLevel": 1,

"cabinName": "经济舱",

"seatLeftNum": 10,

"discount": 0.84,

"cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D21892FDBEFA88420BECC2A1D6BB92C643114274DE1AAADC16119A6E889796A663B074510CC773C96B8DFB75D60EDC6A49D97EEC666AA36F296040F6950C3204B02C6B3E3F18F69E4192053803763F004681832ED7CF366D6EF7B33C2BCE43D7BB6400A90010850DC27A48CB3A987C7EC9703A8D34EC067267F671142CC223113F780FA8CE7F7F7B794904492DF96D3BC7F95DC3E66BE2A749EE508CDD3A5D42E0291FA8A1D97D904442992A88E70C34C84FEADE25719D55E2089FAAC37C1010592038805A63B29F46F7533DEC509E6CCE661D1F8C04C88556DFDAF286015EC0B654384544D2D54D49BDBB29E8F5B9480EB3E47AD9D2D7FF5141DE856698935C7E62E417A09ED465AE1B7498E24E9FA9DA7942E48E9DE3FF9216809DC4E53F9ADFEB4A70665E133C6391971DDB74F418B1",

"cabinPrice": {

"adultFarePrice": 2110,

"adultSalePrice": 2097,

"childFarePrice": 1260,

"childSalePrice": 1266.0,

"babyFarePrice": 260,

"babySalePrice": 270.0,

"cabinClassFullFarePrice": 0

}

},

{

"cabinCode": "S",

"cabinLevel": 1,

"cabinName": "特价舱位",

"seatLeftNum": 6,

"discount": 0.86,

"cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D2AE802E29B8C496892AA06B48447600CE70C0154193BF4C8B959FBDEF4BDD2B575663F5D3AF7017FAC65060D4EA2071D4A939F6D142A1B9BBE9A5A1A6BD2487EC08565C20810DA1895DAB6A55835007C381648A3DF6CD6F6E9283CDA8606A63CCE02EF57ED8A5B678A23E8E3DAF7AEF5E57D447F670266B9B04A6A7E5792CD7C26D2FAEACEE623F90D32A1B39F383E55D27E3797174DE7874BF8E94EFD84A49A43DE7D03D4ACF252D35434BF65B318BE1A515B15BC65E59BACC97CD70F9A8C2C5A4ECE3DE9EEDF1EFAEFBE755EE95A46AAD09391ECDFEB5BE3D85B42C541134336E29183D5D3DF4F66CE226CA5B7FD830B8DD19D65522C7375527CFBA9134E155DA06D8554571E1FABB1CBAB865081455D379A7D3A06F9244F39DCF4564A943429F1A15D5AE4B790BBF5BB29D32EE0256",

"cabinPrice": {

"adultFarePrice": 2160,

"adultSalePrice": 2151,

"childFarePrice": 1260,

"childSalePrice": 1266.0,

"babyFarePrice": 260,

"babySalePrice": 270.0,

"cabinClassFullFarePrice": 0

}

},

{

"cabinCode": "Y",

"cabinLevel": 1,

"cabinName": "经济舱",

"seatLeftNum": 10,

"discount": 1.0,

"cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D27B28D82CB1D7A047488A030326C4CAD941542CBA78EAF87F991634FC4A1681858804FED882F4D4DE7790D81A4274AAFEB6A581ECA2B4EEF41D3D799F785ED802DC0C519E099CDB97DFBA987619E782A073FE58C002F754517E15ED90F7303CBFF3317FE9285B109ED23567884869829731B4DCD8104BDFAEAA20349F9B445D9C3C1FA2616F23D66AC9702EA403FA102545F3898907B2B119E6754DD1FDC9EE1ADAC44B91E5C2B87B87A348A1BE237B714CED46C1B91E2739AEFCC224CC941CF62F8E98852C2AB186574FDC4597E6FC114682FE42C3A642817B5128B4545CC41CD458C6843F47C3063C93019D9D57FA702173241DCDFBBE9D1016AE6416505AD6785F466E437B08C916BF1F0C1D8AF472658465CDF6CDF2BDAE043CA3D17809C87250DC65EDFCE561FD729777C623EE2C",

"cabinPrice": {

"adultFarePrice": 2510,

"adultSalePrice": 2494,

"childFarePrice": 1260,

"childSalePrice": 1266.0,

"babyFarePrice": 260,

"babySalePrice": 270.0,

"cabinClassFullFarePrice": 0

}

},

{

"cabinCode": "C",

"cabinLevel": 2,

"cabinName": "特价舱位",

"seatLeftNum": 4,

"discount": 1.8,

"cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D2912301FEE9235C9807509C8050C3CF1FC6FC3C481C79693F70F3299410EEF962F14751A3286C1CCF936CD35AE196BA767D10AD2BE74BE48B312E2BEEB404C2F921A20A280B615C9F17DEEB19914687B9BD0B84462C95C339D243D6F93D325C9416F7085EC6FA1860D2A84AECF2235560BDE5D64B295E9B14F23F122D146311FFC2473E5984C06253D1DD9A575ED40271F8BF02473924A1A153B2ACA4267B94538D94826016ECA6E81224FD1043688E348D059FE3E18C7C085FCD6040AD372C143CDB5AFD98EB011A8D6C436A572864CC48F9A280B2B0D19BB783B4E8472DE33F1D45236F053E402D4A1514C6C0308DCCAAF981ABAFB2711CF07CE9387593E0BF4DE851B7533C20C7B7270D442C4531C46520862AC65795BB5CDE5DB946119B301913FBB06FDE882E2007D4A2329B8A2B",

"cabinPrice": {

"adultFarePrice": 4520,

"adultSalePrice": 4492,

"childFarePrice": 2890,

"childSalePrice": 2896.0,

"babyFarePrice": 580,

"babySalePrice": 590.0,

"cabinClassFullFarePrice": 0

}

},

{

"cabinCode": "J",

"cabinLevel": 2,

"cabinName": "商务舱",

"seatLeftNum": 8,

"discount": 2.3,

"cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D21D18CF6E6435F33514754BD16C4670A6998A6BBE6A7CC2A4FBAD923B21FE5D2F400F6E952E0CD17FD4FB1B690AA7780FA3D5CCC1A550D1216F942494AD286701C17DBFECDA0614E1153451500D4BC61782EFB5857EE3EEE768DE3F89A80503DB81314E39D934090031666C8FE9FCBD9D68061CE8A231160CEB631CE3C95FFEC0D40C9BA64058615BD386FE6D8F0315C67978EC509BF7E47CBA2698C9F174C17B6F2688DFDABA28C6A84E350B04DCC8B7008102898EC8BDC9C33B516CA263C03B0F5E8FB193B756107B1AB50B87DCDB3517725A566A21F922718E53388130A22C61225F612D0E0472CD6843F2C3E42A2F86114BD5A7263A90784EBB4E30DA4561B0C0D7DC2DDF61A29F96CA1175C806448BD838D1AFB89D6D731F1CB4A75B9BA596BF5F0E7F89A0F9",

"cabinPrice": {

"adultFarePrice": 5770,

"adultSalePrice": 5735,

"childFarePrice": 2890,

"childSalePrice": 2896.0,

"babyFarePrice": 580,

"babySalePrice": 590.0,

"cabinClassFullFarePrice": 0

}

}

],

"yCabinLevelFullPrice": 2510,

"cCabinLevelFullPrice": 5770,

"fCabinLevelFullPrice": null,

"stopNum": 1,

"craftType": "波音738"

}

]

}

},

"success": true,

"msg": "请求成功"

}

相关推荐