OneWorldTrip
English中文
English中文
  1. Cache Refresh API
  • API Integration Guide
  • Flight Ticket Distribution Direct Connect API
    • Search
      POST
    • Verify
      POST
    • Order
      POST
    • Cancel
      POST
    • Order Status Push
      POST
    • Get OrderInfo
      POST
    • Order Copy
      POST
  • Order Management API
    • Order Management Workflow
    • Ticket Issuance
      POST
    • Get Order Details
      POST
    • Get Pending Ticketing Orders
      POST
    • Get after-sales order
      POST
    • Ticket reminder interface
      POST
  • Schedule Change API
    • Schedule Change Workflow
    • Flight Reschedule Notification
      POST
  • Cache Refresh API
    • Refresh Notiry
      POST
    • Cache Refresh
      POST
  • Ancillary Order Management API
    • Ancillary Workflow
    • SeatMap
      POST
    • AuxSearch
      POST
    • Query Ancillary Order List
      POST
    • Update Ancillary Status
      POST
    • Query Ancillary Order Detail
      POST
  1. Cache Refresh API

Cache Refresh

Developing
POST
/api/flight/cacheRefresh
●Endpoint address provided by Partners (as an OTA role).
●On receiving error notifications on a specific flight routing option, OneWorldTrip as the supplier calls out Cache Refresh function to update or clear obsolete cache.

Error Codes#

CodeDescription
0Success
1Refresh frequency too high
2Duplicate request
3Decryption error
4Departure or arrival city is empty
5City not found
6Date is empty
7Date format incorrect
8Date range incorrect
9Not supported for refreshing flights beyond one year or those that have already taken off
10Unknown error
11Request failed
12Only supports one-way or round-trip types
13Unsupported refresh operation
14agentCode missing
15Not supported by this supplier
16No valid group fare quote
101Parameter abnormal
102Unsupported engine
103No differentiated configuration for all markets
104Return information missing
105Unsupported refresh operation
106No valid group fare quote
-1Other failure reasons

Request

Body Params application/jsonRequired

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 09:36:38
Previous
Refresh Notiry
Next
Ancillary Workflow
Built with