알림 API

이벤트 예약 관련 자동 메시지를 발송하여 운영을 간소화하고 효과적으로 규모를 확장하세요

알림 API를 사용하면 Rapid API 과 그 어느 때보다 긴밀하게 연동할 수 있습니다. 예약 변경 사항이 발생하여 귀사의 비즈니스나 운영에 영향을 미칠 수 있는 경우, 알림 API는 해당 변경 사항에 대한 세부 정보를 영향을 받는 모든 당사자에게 직접 전송합니다. 메시지는 상담원, 공급업체 및 Rapid API 자체에서 발송할 수 있습니다. 즉, 콜센터 상담원이 예약을 변경하거나 업체 측에서 예약을 취소할 경우, 고객님께 알림이 전송됩니다. 마찬가지로, API가 새 예약을 성공적으로 생성하면 알림을 받게 되며, 이 알림을 활용하여 내부 시스템과의 연동을 유지할 수 있습니다.

참고: Lodging API에서는 이미 에이전트, 공급업체 및 Rapid API. ‘Car and Activities’ API에서는 현재 agent-initiated 을 통한 예약 변경을 지원하고 있으며, 조만간 Rapid API 내에서 또는 당사의 제휴사를 통해 이루어지는 변경도 지원할 예정입니다.

알림 API는 귀사의 비즈니스와 원활하게 연동되며, 다른 파트너 및 고객 지원 서비스를 보완해 줍니다. Rapid API, 에 새로운 기능과 성능을 추가해 나가는 과정에서, 사용자 경험을 개선하기 위해 새로운 알림 이벤트 유형도 함께 추가할 예정입니다.

이벤트 스키마 및 세부 정보

모든 POST 알림 이벤트는 아래 설명된 스키마를 준수합니다. 새로운 이벤트 유형이 다른 이벤트에 추가되면 스키마가 달라질 수 있습니다.

개체	설명
`event_id`	각 이벤트의 고유한 식별자입니다.
`event_type`	알림을 유발한 이벤트를 나타냅니다. 이 값은 메시지를 처리하고 라우팅하는 데 사용할 수 있습니다. 자세한 내용은 이벤트 유형 목록을 참조해 주세요.
`event_time`	UTC(협정 세계시)로 제공된 이벤트 알림의 타임스탬프입니다.
`itinerary_id`	관련 예약의 일정 ID입니다.
`email`	관련 일정과 연관된 고객 이메일 주소입니다.
`message`	알림 이벤트에 대한 정보입니다. `itinerary.message.received`유형의 이벤트의 경우, 여기에는 공급업체 메시지의 실제 텍스트가 포함됩니다. 다른 모든 이벤트 유형에서는 이해하기 쉬운 정적인 이벤트 설명이 영어로 표시됩니다.
`affiliate_reference_id`	관련 예약의 제휴사 참조 ID입니다.
`topic_tags`	이벤트의 주제 태그입니다. `itinerary.message.received` 유형의 이벤트에만 제공됩니다. 이 목록은 저희 분석 결과 메시지 본문에 포함될 가능성이 있는 것으로 확인된 태그들입니다. >> 숙박 시설 메시지 태그에 대해 자세히 알아보기
`line_of_business`	이 행사가 속한 사업 분야. 사용 가능한 값: `cars`, `flights`, `activities`, `packages` (`properties` 은 곧 제공될 예정입니다). 이 필드는 모든 이벤트 유형에 적용되는 것은 아닙니다. 참고: 이 필드는 현재 Rapid Car, Flight 및 Activities API에서 사용할 수 있으며, Rapid Lodging API에는 아직 포함되지 않았습니다.
`file_name`	file_name 필드를 통해 파트너는 대화에 올바른 파일이 첨부되었는지 확인할 수 있습니다. 참고: 이 필드는 Conversation API를 통해 전송된 첨부 파일에만 적용됩니다.

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

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

지원되는 이벤트 유형

‘신속 알림’ 서비스는 다음의 이벤트에 대해 선제적인 알림을 제공합니다. Rapid의 각 사업 부문마다 지원되는 이벤트가 다릅니다.

숙박 API

Lodging API에서 지원하는 이벤트

Rapid Lodging API는 다음의 모든 이벤트를 지원합니다:

event_type 값	소스	이벤트	세부 정보
`itinerary.agent.create`	고객 지원 상담원 또는 Affiliate Voyager	예약 생성	Rapid 고객 지원 상담원 또는 Affiliate Voyager에서 새로운 예약을 생성했습니다.
`itinerary.agent.change`	고객 지원 상담원 또는 Affiliate Voyager	예약 업데이트	Rapid 고객 지원 상담원 또는 Affiliate Voyager에서 기존 예약을 업데이트했습니다.
`itinerary.agent.cancel`	고객 지원 상담원 또는 Affiliate Voyager	예약 취소	Rapid 고객 지원 상담원 또는 Affiliate Voyager에서 기존 예약을 취소했습니다.
`itinerary.api.create`	Rapid API	일정는 API를 통해 생성되었습니다.	Rapid API 호출을 통해 새 예약이 성공적으로 생성되었습니다. 참고: API를 통해 전화를 걸면 시스템 전반에 걸쳐 단일 정보 소스를 유지할 수 있어 “유령 예약”과 같은 문제를 줄일 수 있습니다.
`itinerary.api.create_failed`	Rapid API	일정, AP를 통한 생성 실패	Rapid API 에서 예약을 생성하려는 시도가 완전히 실패했습니다.
`itinerary.api.change`	Rapid API	일정 API를 통한 업데이트	Rapid API 호출로 인해 기존 예약이 변경되었습니다. 이는 ‘하드 변경’(객실, 날짜, 결제 방식 등)이거나 ‘소프트 변경’(투숙객 정보 등)일 수 있습니다.
`itinerary.api.cancel`	Rapid API	일정가 API를 통해 취소됨	Rapid API 측에서 예약을 취소했습니다.
`itinerary.fraud.cancel`	Expedia	예약 취소	거래에 적용되는 이용약관을 준수하지 않아 Expedia에서 기존 예약을 취소했습니다. 고객이 본인 전화번호와 취소 관련 사항을 논의하기에 가장 편리한 시간을 기재하여 transactionprocessing@travelscape.com으로 문의해야 합니다.
`itinerary.payment_verification.failure`	숙박 시설	신용카드 결제 변경 링크	예약 시 여행자가 제공한 결제 카드가 pre-authorization. 에 따라 익스피디아에서 유효하지 않은 것으로 표시되었습니다. >> 신용카드 재청구 기능에 대해 자세히 알아보기
`itinerary.supplier.cancel`	숙박 시설	예약 취소	기존 예약이 숙박 시설에 의해 취소되었습니다. 고객이 파트너사의 고객 지원 서비스에 문의해야 합니다.
`itinerary.supplier.confirm`	숙박 시설	예약 업데이트	숙박 시설 님이 해당 예약의 숙박 시설 확인 ID를 업데이트했습니다.
`itinerary.supplier.change`	숙박 시설	예약 업데이트	여행객의 도착 지연 또는 조기 체크아웃으로 인해 숙박 시설에 의해 기존 예약이 변경되었습니다.
`itinerary.supplier.refund`	숙박 시설	예약 업데이트	Expedia Collect 예약에 대해 숙박 시설는 여행객이 요청한 환불을 처리하고 있습니다. 여행객이 환불을 받을 수 있도록 하는 것은 파트너의 의무입니다.
`itinerary.traveler.noshow`	숙박 시설	여행객 노쇼	여행객이 나타나지 않았기 때문에, 숙박 시설는 해당 예약을 ‘노쇼’로 처리했습니다.
`itinerary.traveler.checked_in`	숙박 시설	여행자가 숙박 시설에서 체크인했습니다.	공급업체의 기록에 따르면, 해당 여행객은 숙박 시설에서 체크인했습니다.
`itinerary.unspecified.cancel`	Expedia	미상인 당사자에 의해 예약이 취소되었습니다.	이 알림은 예약이 취소되었으나, 시스템에서 해당 취소가 여행자, 숙박 시설/호스트, 또는 여행사 중 누구에 의해 이루어졌는지 확인할 수 없는 경우에 발송됩니다. 이 기능은 주로 Rapid API 에서 취소 당사자를 확인할 수 없는 Vrbo 예약과, 취소 당사자가 불분명한 일정 항공편 취소 건에 사용됩니다. 취소 사유가 불분명하기 때문에, 파트너들은 알림만으로는 누가 취소를 요청했는지 파악할 수 없습니다.
`itinerary.unspecified.change`	Expedia	신원 미상의 당사자에 의해 예약이 변경되었습니다.	이 알림은 기존 예약이 변경되었으나(“하드 변경”), 해당 변경이 여행자, 숙박 시설/호스트 또는 여행사 직원에 의해 이루어졌는지 시스템에서 파악할 수 없는 경우에 발송됩니다. 주로 다음 사이트의 Vrbo 예약에 사용됩니다. Rapid API. 이 알림을 수신하면 파트너사는 ‘예약 조회(Booking Retrieve)’ 호출을 수행하여 변경된 내용을 확인하고 업데이트된 예약 세부 정보를 확인해야 합니다.
`itinerary.message.received`	숙박 시설	새 메시지 전송됨	숙박 시설 님이 숙박 시설 메시지 센터(PMC) 또는 대화 API를 통해 새 메시지를 보냈습니다. >> 당사의 대화 솔루션에 대해 자세히 알아보기
`itinerary.message.rejected`	수요 파트너 / 여행자	사기 또는 피싱이 감지되었습니다	여행자나 수요 파트너 에이전트가 보낸 메시지가 사기 또는 피싱으로 판명되어 차단됩니다. 메시지가 차단되어 전달되지 않았습니다.
`itinerary.conversation.attachment.success`	수요 파트너 / 여행자	첨부 파일 업로드에 성공했습니다.	여행자나 수요 파트너 에이전트가 대화의 일부로 보낸 첨부 파일이 성공적으로 업로드되어 대화에 추가되었습니다.
`itinerary.conversation.attachment.failure`	수요 파트너 / 여행자	파일 업로드에 실패했습니다.	대화 내용의 일부로 여행자나 수요 파트너 에이전트가 보낸 첨부 파일이 S3 버킷에는 업로드되었으나, 대화 내에는 업로드되지 않았습니다.

itinerary.agent.create 예시

{
     "event_id": "dbacce6c-afcb-4b23-ae66-48050757551c",
     "event_type": "itinerary.agent.create",
     "event_time": "2026-08-09T16:47:32.039Z",
     "itinerary_id": "8091234567890",
     "email": "customer@example.com",
     "message": "An agent created a new itinerary.",
     "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
 }

itinerary.supplier.confirm 예시

{
    "event_id": "e02d6f41-4708-476f-915d-8a7032942e94",
    "event_type": "itinerary.supplier.confirm",
    "event_time": "2027-04-28T20:31:03.423Z",
    "itinerary_id": "8999989898988",
    "email": "alice@example.com",
    "message": "The supplier confirmed one or more rooms on this itinerary.",
    "affiliate_reference_id": "R194193582",
    "rooms": [
        {
            "confirmation_id": {
                "expedia": "926784314",
                "property": "BEF23123AA"
            }
        },
        {
            "confirmation_id": {
                "expedia": "926784315"
            }
        }
    ]
}

itinerary.message.received 예시

{
  "event_id": "1aed5641-7285-4c42-b079-f5f2f139d148",
  "event_type": "itinerary.message.received",
  "event_time": "2027-11-14T02:33:18.860105363Z",
  "itinerary_id": "9025254271673",
  "email": "john@email.com",
  "message": " We accept your request for a river view room. You will be able to check in at 11:00 AM. Please also note that the pool will be closed for scheduled maintenance on the day of your arrival, it will be open normal hours (9 AM to 10 PM) for the remainder of your stay. Looking forward to your visit.",
  "topic_tags": "Check-in, Property/Amenity Closure",
  "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}

렌터카 API

Car API에서 지원하는 이벤트

현재 Rapid Car API는 예약 취소라는 단 하나의 알림 이벤트만 지원합니다. 추가 행사가 현재 등록되고 있습니다. 사용 가능해지면 여기에 목록을 올리겠습니다.

event_type 값	소스	이벤트	세부 정보
`itinerary.agent.cancel`	고객 지원 상담원 또는 Affiliate Voyager	예약 취소	Rapid 고객 지원 상담원 또는 Affiliate Voyager에서 기존 예약을 취소했습니다.

액티비티 API

Activities API에서 지원하는 이벤트

현재 Rapid Activities API는 두 가지 알림 이벤트를 지원합니다. 추가 행사가 현재 등록되고 있습니다. 사용 가능해지면 여기에 목록을 올리겠습니다.

event_type 값	소스	이벤트	세부 정보
`itinerary.agent.cancel`	고객 지원 상담원 또는 Affiliate Voyager	예약 취소	Rapid 고객 지원 상담원 또는 Affiliate Voyager에서 기존 예약을 취소했습니다.
`itinerary.supplier.cancel`	공급업체	예약 취소	기존 예약이 공급업체 측에서 취소되었습니다. 고객이 파트너사의 고객 지원 서비스에 문의해야 합니다.

API 세부 정보

이 페이지에서 알림 관련 엔드포인트 정의를 살펴본 후 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요. 또한, 당사의 알림 API와의 연동 상태를 테스트하는 데 사용할 수 있는 ‘알림 테스터’도 마련되어 있습니다.