通知 API

イベントの予約に関する自動メッセージを送信することで、業務を簡素化し、効果的に規模を拡大しましょう

Notifications APIを使用すると、Rapid APIとの連携をこれまで以上に緊密に行うことができます。ご予約の変更により、お客様のビジネスや業務に影響が生じる可能性がある場合、通知APIがその変更の詳細を、影響を受けるすべての関係者に直接通知いたします。メッセージは、エージェント、ベンダー、およびRapid API自体によって送信されることがあります。つまり、コールセンターの担当者が変更を加えた場合や、ベンダーが予約をキャンセルした場合、お客様に通知が届きます。同様に、APIによる新規予約の作成が正常に完了した場合、通知が届きます。この通知を活用して、社内システムとの整合性を維持することができます。

注： Lodging APIでは、エージェント、ベンダー、およびRapid API. CarおよびActivities APIでは、現在agent-initiatedでの予約変更に対応しており、まもなくRapid API内および当社のベンダーによる変更にも対応する予定です。

通知APIは、お客様のビジネスとのシームレスな連携を可能にし、他のパートナーやカスタマーサポートサービスを補完するものです。Rapid API, に新機能や機能を追加していくにつれ、ユーザーの皆様の利便性を高めるため、新しい通知イベントの種類も追加していく予定です。

イベントスキーマと詳細

すべての POST 通知イベントが下記のスキーマに従います。さまざまなイベントに新しいイベントタイプが加えられるため、この構成は変更されることがあります。

オブジェクト	説明
`event_id`	各イベントの一意の識別子。
`event_type`	どのイベントが通知のきっかけとなったかを示します。この値はメッセージのハンドリングとルーティングに使用できます。詳細についてはイベントタイプのリストを参照してください。
`event_time`	イベント通知のタイプスタンプ (協定世界時)。
`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 Notifications」サービスでは、以下のイベントについて、事前の通知メッセージを提供いたします。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への電話により、既存の予約に変更が生じました。変更内容には、ハードチェンジ（客室、日程、支払い方法など）とソフトチェンジ（宿泊者の詳細など）の2種類があります。
`itinerary.api.cancel`	Rapid API	APIを介して旅程がキャンセルされました	Rapid APIからの電話により、ご予約がキャンセルされました。
`itinerary.fraud.cancel`	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"
}

Car API

Car APIでサポートされているイベント

現時点では、Rapid Car APIがサポートしている通知イベントは、予約のキャンセルのみです。現在、さらにイベントが追加される予定です。入手可能になり次第、こちらに掲載いたします。

event_type の値	発生元	発生イベント	詳細
`itinerary.agent.cancel`	カスタマーサポートエージェントまたは Affiliate Voyager	予約のキャンセル	Rapid カスタマーサポートエージェントまたは Affiliate Voyager で既存の予約が取り消されました。

Activities API

Activities APIでサポートされているイベント

現時点では、Rapid Activities APIは2つの通知イベントをサポートしています。現在、さらにイベントが追加される予定です。入手可能になり次第、こちらに掲載いたします。

event_type の値	発生元	発生イベント	詳細
`itinerary.agent.cancel`	カスタマーサポートエージェントまたは Affiliate Voyager	予約のキャンセル	Rapid カスタマーサポートエージェントまたは Affiliate Voyager で既存の予約が取り消されました。
`itinerary.supplier.cancel`	サプライヤー	予約のキャンセル	既存の予約がサプライヤーによってキャンセルされました。お客様は担当のカスタマーサポートに連絡する必要があります。

API の詳細

このページで通知関連のエンドポイント定義を調べてから、API Explorer または別のテストソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。また、当社の通知APIとの連携をテストするためにご利用いただける「通知テスター」もご用意しております。