NDC Search

  • Endpoint : https://api.pp.travelport.com/11/air/catalog/search/catalogproductofferings

Search 종류

  • Initial flight search : 첫 번째 항공편에 대한 초기 검색
  • Search for flights on next leg : 결과 Initial (Lowfare) 결과 에서 항공편의 경로를 추가적으로 검색
  • Return all upsells on a specific flight – reference payload : 업셀 옵션(예: 좌석 업그레이드, 추가 서비스 등)을 참조 Lowfare를 사용하여 조회
  • Return all upsells on a specific flight – full payload : 업셀 옵션을 Lowfare 형식으로 조회 (LowfareSearch)
  • Search by air availability : 좌석조회 기준으로 항공편을 검색(운임 X)

본사설명 : https://support.travelport.com/webhelp/JSONAPIs/Airv11/Content/Air11/Search/APIRef_Search.htm#req

CustomResponseModifiersAir

SearchRepresentation:

  • 여정 전체에 대한 제안(Journey) 또는 첫 구간만(Leg) 반환하는지를 설정합니다.
  • Journey: 전체 여정에 대한 제안을 반환합니다. 기본값.
  • Leg: 첫 구간만 반환하고, 이후 구간은 추가 요청 필요.

includeFlightAmenitiesInd:

  • true: 항공편의 편의시설 정보를 응답에 포함.
  • false 또는 미전송: 편의시설 정보 제외.

excludeBaggageFeesInd:

  • true: 수하물 요금, 휴대 수하물 요금, 제한 정보 제외.
  • false 또는 미전송: 해당 정보 포함.

excludeSurchargesInd:

  • true: 추가 요금 세부 사항 제외.
  • false 또는 미전송: 추가 요금 포함.

includeFareCalculationInd:

  • true: 운임 계산 구조(Fare Calculation Ladder) 반환.
  • false 또는 미전송: 운임 계산 구조 제외.

includeCo2EmissionsDataInd:

  • true: CO2 배출량 데이터 반환.
  • false 또는 미전송: CO2 배출량 데이터 제외.

CatalogProductOfferingsRequest

maxNumberOfOffersToReturn: 사용되지 않으며, 전송해도 무시됩니다.

offersPerPage:

  • 숫자 입력 시, 여정 기반 검색 결과를 캐시하여 이후 참조 요청에서 사용 가능하게 합니다. // isJourney사용시 1 기본으로 사용
  • 전송하지 않으면 여정 기반(“SearchRepresentation”: “isJourney”) 검색 결과는 캐시되지 않으며, 참조 요청이 실패할 수 있습니다.
  • 구간 기반 검색은 자동으로 캐시됩니다.
  • 0 세팅시 : “Identifier”: {“value”: “6edb0dfd-9dc4-4f42-92f5-96f5df024655”}, 가 나오지 않음

contentSourceList:

  • GDS: GDS 콘텐츠만 반환.
  • NDC: NDC 콘텐츠만 반환.
  • GDS와 NDC 모두 전송: 통합 콘텐츠 반환.
  • 전송하지 않으면 GDS 콘텐츠만 반환.

maxNumberOfUpsellsToReturn:

  • 숫자 (최대 4): 기본 요금에 대해 최대 4개의 업셀 요금을 반환.
  • GDS 미전송 또는 0: 최저가 요금만 반환.
  • NDC 미전송: 각 브랜드/객실의 최저가 요금 반환.

PassengerCriteria

PassengerCriteria (배열): 각 승객 유형(PTC)에 대해 하나씩 설정해야 합니다. 최대 9명의 승객을 지원하며, GDS는 최대 6개의 PTC를, NDC는 제한이 없습니다.

passengerTypeCode (필수): 승객 유형 코드. 주요 코드:

  • ADT: 성인
  • CHD: 나이를 알 수 없는 어린이
  • CNN: 나이가 알려진 어린이 (보통 2~11세)
  • INF: 좌석 없는 유아 (0~1세)
  • INS: 좌석 있는 유아
  • UNN: 보호자 없는 어린이

number (필수): 해당 승객 유형의 승객 수.

age (선택 사항): 승객의 나이. 특정 요금 계산에 나이를 사용하는 PTC에만 포함 권장.

  • CNN: 어린이(2~11세). 보통 12세 이상은 ADT 요금.
  • INF: 나이는 0 또는 1이어야 함.
  • 다중 승객 검색 시, specifiedPassengerTypeCodeOnlyInd를 true로 설정하면 선택된 PTC에 대한 요금만 반환.

specifiedPassengerTypeCodeOnlyInd (GDS 전용): true로 설정 시 해당 PTC에만 맞는 제안만 반환합니다.

SearchModifiersAir

SearchModifiersAir: 여정 전체에 적용되는 선택적 검색 수정자. 각 구간별 설정은 legSequence로 지정할 수 있습니다.

excludeGround (선택 사항):

  • All: 모든 지상 교통(기차, 버스 등) 제외.
  • Train: 기차만 제외하고 다른 지상 교통은 포함.
  • 기본값은 모든 지상 교통이 포함되며, GDS 전용(NDC는 지원하지 않음).

prohibitChangeOfAirportInd (선택 사항):

  • true: 환승 시 공항 변경이 필요한 여정을 제외.
  • false (기본값): 공항 변경이 포함된 여정을 허용.

ConnectionPreferences

ConnectionPreferences: 연결(환승) 설정을 통해 선호 조건을 지정합니다. GDS 전용이며, NDC는 지원하지 않습니다.

MaxConnectionDuration (선택 사항): 구간 내 연결 시간이 설정 시간(예: “PT3H”)을 초과하지 않는 여정만 반환. ISO-8601 형식을 사용.

MaxOvernightDuration (선택 사항): 밤새 연결 시 최대 대기 시간 제한. 첫 비행이 도착하고 연결 비행이 다음 날 출발하는 경우에 적용됨. ISO-8601 형식을 사용.

cityOrAirport (선택 사항): 도시 또는 공항 코드를 기준으로 검색 제한.

  • City Only: 도시 내 모든 공항 검색.
  • Airport Only: 지정된 공항만 검색.
  • City or Airport: 지정된 코드에 맞는 모든 공항 검색.

legSequence (선택 사항): 특정 구간에만 적용할 경우 구간 번호로 설정. 여정 전체에 적용할 경우 사용하지 않음.

preferenceType (필수): 연결에 대한 선호 유형.

  • Permitted: 지정된 연결 지점을 포함하는 결과만 반환.
  • Prohibited: 지정된 연결 지점을 제외한 결과만 반환.
  • Preferred: 지정된 연결 지점이 포함된 결과에 가중치 부여.

ConnectionPoint (필수): 연결 지점의 IATA 코드(예: LAX). 여러 연결 지점을 설정할 수 있으며, preferenceType에 따라 해당 지점들이 허용, 제외, 또는 가중치가 부여됩니다.

FlightType

FlightType: 연결 및 경유와 관련된 검색 조건을 지정하는 객체.

connectionType (선택 사항):

  • NonStopDirect: 경유 없이 목적지까지 직항.
  • StopDirect: 경유하나 항공편 번호는 동일.
  • SingleConnection: 한 번의 비행기 환승 필요.
  • DoubleConnection: 두 번의 비행기 환승 필요.
  • 선택한 유형 및 상위 유형까지 결과에 포함됩니다. 예를 들어, SingleConnection을 선택하면 StopDirect도 포함될 수 있습니다.

excludeInterlineConnectionsInd (선택 사항):

  • true: 다중 항공사의 인터라인 연결 제외.
  • false (기본값): 인터라인 연결 포함.
  • GDS 전용이며, NDC는 인터라인 연결을 지원하지 않음.

ProductInclusionPreference

ProductInclusionPreference: 특정 브랜드 속성이 포함된 요금만 반환하도록 검색 범위를 제한.

Classification (선택 사항):

  • 지정된 속성(예: CarryOn, Refund, Meals 등)이 포함된 요금만 반환.
  • 사용 가능한 속성 목록:
    • CarryOn: 기내 수하물
    • Refund: 환불 가능
    • Meals: 식사 제공
    • Rebooking: 예약 변경 가능
    • CheckedBag: 위탁 수하물 포함
    • SeatAssignment: 좌석 지정 포함
    • WiFi: WiFi 포함
    • LieFlatSeat: 평면 좌석 제공
    • PremiumSeat: 프리미엄 좌석 제공
    • PersonalItem: 개인 소지품 포함
  • 지원되지 않는 속성을 보내면 ProductInclusionPreference는 무시되며 최저 요금이 반환됩니다.
Split Ticketing

Req

Rsp