ラピッドアクティビティAPIの概要
Rapid Activities APIで旅行者がアクティビティや体験を予約できるようにします。
アーリーアクセス・プレビュー
このドキュメントは、選ばれたパートナーだけを対象とした早期アクセス・プレビュー・イニシアチブの一部です。パイロット・プログラムは2026年第2四半期に開始され、2027年に一般提供が開始される予定です。
パイロットまたはベータ・パートナーにご興味のある方は、アカウントマネージャーまでご連絡ください。
Rapid Activities APIは、簡単に統合でき、end-to-endショッピングと予約のフローを通じて旅行者にアクティビティを紹介できるように設計されています。これにより、旅行者により総合的な体験を提供すると同時に、新たな収益源を確保することができます。
キーコンセプト
| 契約期間 | 定義 |
|---|---|
| 現地ツアー | 予約可能なイベント（何を見せ、何を売るのか）。 |
| 活動グループ | 似たような活動の束。 |
| 体験 | 複数のアクティビティが含まれる可能性のある、概念的／マーケティング的なラッパー。 |
| チケット | アクティビティの予約タイプ（大人/子供/幼児など）。 |
| 予約詳細 | 1つのアクティビティと1枚以上のチケットを含む予約（アクティビティ予約）です。 |
| カテゴリー | High-level体験や活動をテーマに分類するグループ分け（例えば、市内観光、博物館、野外活動など）。 |
| 属性 | 体験やアクティビティの具体的な特徴をとらえた説明的なフラグ（例えば、車椅子でアクセス可能、「家族向け」、「ガイド付きツアー」、「列をスキップ」など）。 |
エンド・ツー・エンドの統合フロー
このAPIを使用したアクティビティの予約は、この一般的な流れに従います。
ステップ1：在庫の発見
デスティネーションで何を販売できるかを理解し、デスティネーション別のアクティビティの構造化されたカタログを作成し、商品化できるようにします。
- リージョン を、リージョンマッピングのエンドポイントを使用して、基礎となるインベントリ（経験、アクティビティ、アクティビティグループ）にマッピングします。注：Activities APIは、こ の反復では
region_IDパラメータのみをサポートします。 - リッチなアクティビティコンテンツ（タイトル、説明、画像、場所、カテゴリー）を多言語で表示します。
- 旅行者がオプションを比較し、体験に対する信頼を築けるよう、アクティビティに対するゲストの評価やレビューを引き出します。
- 検索結果、アクティビティ詳細ページ、フィルター（「家族向け」や「ウォーキングツアー」など）を入力します。
ステップ2: 空室状況と価格の検索
アクティビティがいつ、いくらで利用できるかを知ることができます。予約可能な日時、航空券のオプション、価格帯を活用して、ショッピングの旅をサポートします。
- 特定のアクティビティや日程については、チケットの種類別に空席状況と料金をお問い合わせください。
- ショッパーエクスペリエンスにカレンダー（予約可能日/予約不可能日）、時間帯、開始価格を表示します。
- 1回の通話で複数のアクティビティをサポート
ステップ3:Pre-booking価格チェック
最終的な予約可能価格を確認し、支払い前に予約必須項目のリストを取得します。最新の在庫とポリシーに沿った確定オファーと予約トークンを受け取ります。
- 特定の選択（アクティビティ、日付、時間、チケット）をリアルタイムで検証します。
- 最終価格、税金/手数料、空席状況（価格変更や売り切れを含む）をご確認いただけます。
- 予約に必要なフィールド（乗客の詳細やpick-upタイプなど）の詳細と、予約用の安全なトークンを取得します。
ステップ4: 予約の作成
確定した選択を予約に変更します。お客様のシステムで表示・管理できる確定旅程表（予約）をお受け取りください。
- ショッピングフローから予約トークンをクエリパラメータとして送信し、Payments APIから
payment_token、旅行者の詳細（プライマリおよび追加の旅行者）と共にリクエストボディに送信します。 - 後で予約の照合や検索ができるように、ご自身のアフィリエイト・レファレンスを添付してください。
- 旅程IDと予約詳細を取得するためのリンクを受信します。
ステップ5：予約管理
顧客とエージェントの予約後のワークフローをサポートします。予約完了後のツールセットにアクセスして、既存の予約の表示、キャンセル、バウチャーの提供を行います。
- 旅程IDまたはアフィリエイトリファレンスから予約の詳細を検索します。
- 許可された場合は予約をキャンセルし、その結果をお客様にお知らせします。
- お客様がアクティビティで提示する伝票書類を回収します。
エラー応答のテスト
指定されたRapid Activities APIメソッドのテストリクエストを送信するには、ショッピングまたは予約リクエストにtest というHTTPヘッダーを追加し、以下の表から適切な値を使用してください。テストヘッダを送らなかったり、無効なテストヘッダを送ったりすると、リクエストはライブで処理されます。
注： テストヘッダを使用すると静的なメッセージが返されるため、返されるレートや内容はテスト中のアクティビティに関連しない場合があります。
ショッピングとコンテンツAPI
| Test ヘッダーの値 | HTTP コードとレスポンス | ステータス |
|---|---|---|
| スタンダード | 200 OK (標準成功レスポンス) | Success |
bad_link | 400不正なリクエスト (不正なリンク) | エラー |
invalid_input | 400不正なリクエスト (無効な入 力) | エラー |
internal_server_error | 500内部サーバーエラー（不明なエラー） | エラー |
service_unavailable | 503サービスは利用できません | エラー |
Booking API
| Test ヘッダーの値 | HTTP コードとレスポンス | ステータス |
|---|---|---|
| スタンダード | 200 OK (標準成功レスポンス) | Success |
bad_link | 400不正なリクエスト (不正なリンク) | エラー |
invalid_input | 400不正なリクエスト (無効な入力) | エラー |
price_mismatch | 409コンフリクト（価格の不一致） | エラー |
sold_out | 410コンフリクト（完売） | エラー |
internal_server_error | 500内部サーバーエラー（不明なエラー） | エラー |
service_unavailable | 503サービスは利用できません | エラー |
API の詳細
このページでactivity-relatedのエンドポイント定義を調べ、Postmanのようなテストソフトを使って、例とスキーマ定義が実際の出力と比較してどうなのかを理解しましょう。このAPIが試験段階を過ぎたら、そのエンドポイントも私たちのAPI Explorer。