- 接入说明
- 机票分销 内容聚合直连API
- 分销订单管理API
- 航变API
- 缓存刷新API
- 辅营订单管理API
缓存刷新接口（CacheRefresh）
POST
/api/flight/cacheRefresh
接口地址分销端提供，乐游供应商在接收到消息通知后，可以利用缓存刷新接口对相关航线进行缓存更新或删除。此接口允许乐游供应端根据最新的信息更新缓存数据，或删除不再有效的数据，以确保系统中的信息保持最新状态。
错误码#
| 代码 | 描述 |
|---|---|
| 0 | 成功 |
| 1 | 刷新频率过高 |
| 2 | 重复请求 |
| 3 | 解密出错 |
| 4 | 出发或到达城市为空 |
| 5 | 没找到这个城市 |
| 6 | 日期为空 |
| 7 | 日期格式不对 |
| 8 | 日期区间不对 |
| 9 | 不支持刷新一年以后及已起飞的航班 |
| 10 | 未知的错误 |
| 11 | 请求失败 |
| 12 | 仅支持单程或往返类型 |
| 13 | 不支持的刷新操作 |
| 14 | agentCode缺失 |
| 15 | 暂不支持该供应商 |
| 16 | 无有效的航组报价 |
| 101 | 参数异常 |
| 102 | 不支持的引擎 |
| 103 | 所有市场均未进行差异化配置 |
| 104 | 返程信息缺失 |
| 105 | 不支持的刷新操作 |
| 106 | 无有效的航组报价 |
| -1 | 其他失败原因 |
Request
Body Params application/json
Example
{
"request":
{
"vendorCode": "xxxxxxxx",
"tripType": "1",
"depCity": "SEL",
"arrCity": "HKG",
"fromDate": "20251122",
"cabinClass":"Y",
"cutOffTime":"5000",
"retDate": "",
"adultNumber": 1,
"childNumber": 0,
"infantNumber": 0
},
"response":
{
"msg": "success",
"timeLapse": 1761120744219,
"status": 0,
"shoppingResultList":
[
{
"flightRefList":
[
{
"flightRefNum": 1,
"travelDirection": 1,
"flightSeq": 1,
"ticketSeq": 1,
"cabinClass": "Y",
"rbd": "S",
"seatCount": 6
}
],
"data": "6790f2e9-fb5d-486e-b0b9-2e2c40df31f5#973978ff-58b3-4ca6-bb49-f351ef53c721#AT526_E_AT750_E#1",
"ticketList":
[
{
"ticketSeq": 1,
"priceList":
[
{
"passengerType": 0,
"fare": 248.27,
"tax": 35.70
}
],
"validatingCarrier": "KE",
"productType": "PUB",
"fareBasis": "SLE00RKC",
"freeBaggageList":
[
{
"travelDirection": 1,
"flightSeq": 1,
"baggagePiece": 1,
"baggageWeight": 23,
"passengerType": 0,
"carryOnPiece": 0,
"carryOnWeight": -1
}
],
"refundInfoList":
[
{
"passengerType": 0,
"refundType": 0,
"conditionList":
[
{
"start": "-1",
"end": "-1",
"unit": "m",
"refundable": true,
"refundFee": "116.33",
"currency": "USD"
}
]
}
],
"changeInfoList":
[
{
"passengerType": 0,
"changeType": 0,
"conditionList":
[
{
"start": "-1",
"end": "-1",
"unit": "m",
"changeable": true,
"changeFee": "84.60",
"currency": "USD"
}
]
}
],
"currency": "USD",
"ticketTimeUnit": 120
}
]
}
],
"flightList":
[
{
"aircraftCode": "789",
"arrAirport": "HKG",
"arrTerminal": "1",
"arrTime": "202511221120",
"codeShare": false,
"depAirport": "ICN",
"depTerminal": "2",
"depTime": "202511220810",
"flightNumber": 2001,
"flightRefNum": 1,
"marketingCarrier": "KE",
"operatingCarrier": "KE",
"operatingFlightNumber": 2001,
"duration": "250"
}
]
}
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://58.250.183.7:31011/api/flight/cacheRefresh' \
--header 'Content-Type: application/json' \
--data-raw '{
"request":
{
"vendorCode": "xxxxxxxx",
"tripType": "1",
"depCity": "SEL",
"arrCity": "HKG",
"fromDate": "20251122",
"cabinClass":"Y",
"cutOffTime":"5000",
"retDate": "",
"adultNumber": 1,
"childNumber": 0,
"infantNumber": 0
},
"response":
{
"msg": "success",
"timeLapse": 1761120744219,
"status": 0,
"shoppingResultList":
[
{
"flightRefList":
[
{
"flightRefNum": 1,
"travelDirection": 1,
"flightSeq": 1,
"ticketSeq": 1,
"cabinClass": "Y",
"rbd": "S",
"seatCount": 6
}
],
"data": "6790f2e9-fb5d-486e-b0b9-2e2c40df31f5#973978ff-58b3-4ca6-bb49-f351ef53c721#AT526_E_AT750_E#1",
"ticketList":
[
{
"ticketSeq": 1,
"priceList":
[
{
"passengerType": 0,
"fare": 248.27,
"tax": 35.70
}
],
"validatingCarrier": "KE",
"productType": "PUB",
"fareBasis": "SLE00RKC",
"freeBaggageList":
[
{
"travelDirection": 1,
"flightSeq": 1,
"baggagePiece": 1,
"baggageWeight": 23,
"passengerType": 0,
"carryOnPiece": 0,
"carryOnWeight": -1
}
],
"refundInfoList":
[
{
"passengerType": 0,
"refundType": 0,
"conditionList":
[
{
"start": "-1",
"end": "-1",
"unit": "m",
"refundable": true,
"refundFee": "116.33",
"currency": "USD"
}
]
}
],
"changeInfoList":
[
{
"passengerType": 0,
"changeType": 0,
"conditionList":
[
{
"start": "-1",
"end": "-1",
"unit": "m",
"changeable": true,
"changeFee": "84.60",
"currency": "USD"
}
]
}
],
"currency": "USD",
"ticketTimeUnit": 120
}
]
}
],
"flightList":
[
{
"aircraftCode": "789",
"arrAirport": "HKG",
"arrTerminal": "1",
"arrTime": "202511221120",
"codeShare": false,
"depAirport": "ICN",
"depTerminal": "2",
"depTime": "202511220810",
"flightNumber": 2001,
"flightRefNum": 1,
"marketingCarrier": "KE",
"operatingCarrier": "KE",
"operatingFlightNumber": 2001,
"duration": "250"
}
]
}
}'Responses
🟢200成功
application/json
Body
Example
{
"status": 0,
"msg": "success"
}Modified at 2025-10-22 08:23:03