알림

다양한 예약 이벤트에 대한 알림을 받아 운영을 간소화하고 효과적으로 확장하세요.

알림 서비스를 통해 빠른 비행 API와 긴밀하게 통합할 수 있습니다. 비즈니스나 운영에 영향을 미칠 수 있는 예약 변경 사항이 발생하면 알림 서비스는 표준 POST 메시지를 통해 변경 사항에 대한 세부 정보를 시스템으로 직접 푸시합니다. 이러한 푸시 알림을 통해 계속해서 정보를 얻고 운영 작업을 간소화하며 비즈니스를 확장할 수 있습니다.

현재 API 외부에서 발생하는 post-booking 이벤트에 대한 알림을 지원하고 있습니다. 예를 들어 콜센터 상담원이 예약을 변경하거나 취소하면 즉시 알림을 받을 수 있습니다.

빠른 비행 API에 기능을 추가하면서 사용자 경험을 개선하기 위해 새로운 알림 이벤트 유형도 추가하는 경우가 많습니다.

이러한 알림은 비즈니스와의 원활한 통합을 가능하게 함으로써 Rapid API, Affiliate Voyager, 및 기타 파트너 및 고객 지원 서비스를 보완하는 역할을 합니다.

이벤트 세부 정보

모든 POST 알림 이벤트는 아래 설명된 값을 준수합니다. 다양한 이벤트에 대해 새로운 이벤트 유형이 추가됨에 따라 값이 달라질 수 있습니다.

개체	설명
`affiliate_reference_id`	관련 예약의 제휴사 참조 ID입니다.
`email`	관련 일정과 연관된 고객 이메일 주소입니다.
`event_id`	각 이벤트의 고유한 식별자입니다.
`event_time`	UTC(협정 세계시)로 제공된 이벤트 알림의 타임스탬프입니다.
`event_type`	알림을 유발한 이벤트를 나타냅니다. 이 값은 메시지를 처리하고 라우팅하는 데 사용할 수 있습니다. 자세한 내용은 이벤트 유형 목록을 참조하세요.
`itinerary_id`	관련 예약의 일정 ID입니다.

각 알림은 HTTPS POST 메시지 본문이 포함된 JSON 요청입니다.

참고: 이러한 종류의 알림을 받으려면 각 이벤트 유형을 개별적으로 활성화해야 합니다. 새로운 알림 이벤트 유형을 활성화하려면 지원팀에 문의해 주세요.

지원되는 이벤트 유형

항공편 알림 서비스는 다음과 같은 이벤트에 대해 메시지를 통해 시스템에 알릴 수 있습니다:

`event_type` 값	소스	이벤트	세부 정보
`itinerary.supplier.ticket`	항공사	항공편 예약	항공사가 예약을 확정하고 항공권을 발권했습니다(발권된 항공편의 경우).
`itinerary.unspecified.change`	복수	항공편 변경	여행자, 여행사 또는 항공사가 기존 예약을 업데이트한 경우(일정 변경과 같은 비자발적 변경의 경우).
`itinerary.unspecified.cancel`	복수	항공편 취소	여행자, 항공사 또는 여행사에 의해 기존 예약이 취소된 경우.
`itinerary.supplier.refund`	항공사	항공권 환불	항공사는 여행자가 요청한 환불을 제공하고 있습니다. 항공사가 기록상 판매자인 경우, 여행자가 환불을 받을 수 있도록 하는 것은 해당 항공사의 의무입니다.
`itinerary.unspecified.void`	복수	비행 무효	여행자, 항공사 또는 여행사에 의해 기존 예약이 무효 처리되었습니다.

공급업체 발권 코드 샘플

{  
    "affiliate_reference_id": "",  
   "email": "abc123@gmail.com",  
   "event_id": "dcec1653-3b7f-4b03-b056-50176642869d",  
   "event_time": "2025-12-10T17:15:13.115Z",  
   "event_type": "itinerary.supplier.ticket",  
   "itinerary_id": "9025417059279",  
   "message": "The supplier issued a ticket for this flight itinerary."  
}

지정되지 않은 변경 코드 샘플

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
 "event_id": "ab1bce97-175d-43d9-91c8-b09cdbf5ea46",  
  "event_time": "2025-12-10T17:15:21.016Z",  
  "event_type": "itinerary.unspecified.change",  
  "itinerary_id": "9025417973523",  
  "message": "This flight itinerary was changed."  
}

지정되지 않은 취소 코드 샘플

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
  "event_id": "221b5da6-820a-4e7b-85bd-1ba7639abda1",  
  "event_time": "2025-12-10T17:15:16.840Z",  
  "event_type": "itinerary.unspecified.cancel",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was canceled."  
}

공급업체 환불 코드 샘플

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.supplier.refund",  
  "itinerary_id": "9025417466019",  
  "message": "The supplier initiated a refund for this flight itinerary."  
}

지정되지 않은 보이드 코드 샘플

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.unspecified.void",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was voided."  
}