ラピッドアクティビティAPIの概要
Rapid Activities APIで旅行者がアクティビティや体験を予約できるようにします。
アーリーアクセス・プレビュー
このドキュメントは、選ばれたパートナーだけを対象とした早期アクセス・プレビュー・イニシアチブの一部です。パイロット・プログラムは2026年第2四半期に開始され、2027年に一般提供が開始される予定です。
パイロットまたはベータ・パートナーにご興味のある方は、ア カウントマネージャーまでご連絡ください。
Rapid Activities APIは、簡単に統合でき、end-to-endショッピングと予約のフローを通じて旅行者にアクティビティを紹介できるように設計されています。これにより、旅行者により総合的な体験を提供すると同時に、新たな収益源を確保することができます。
キーコンセプト
- 活動： 予約可能なイベント（展示・販売するもの）。
- 活動グループ： 似たような活動の集まり。
- 経験： 複数の活動を含む概念的／マーケティング的なラッパー。
- チケット： アクティビティのチケットの種類（大人／子供／幼児など）。
- 日程表： 1つのアクティビティと1 枚以上のチケットを含む予約（アクティビティ予約）。
- カテゴリー： High-level体験や活動をテーマに分類したグループ分け（例えば、市内観光、博物館、野外活動など）。
- 属性： 体験やアクティビティ（例えば、車椅子でアクセス可能、家族向け、ガイド付きツアー、スキップラインなど）の具体的な特徴をとらえた説明的なフラグ。
エンド・ツー・エンドの統合フロー
このAPIを使用したアクティビティの予約は、この一般的な流れに従います。
ステップ1：在庫の発見
デスティネーションで何を販売できるかを理解し、デスティネーション別のアクティビティの構造化されたカタログを作成し、商品化できるようにします。
- Geography APIの地域 を、地域マッピングエンドポイントを使用して、基礎となるインベントリ（エクスペリエンス、アクティビティ、およびアクティビティグループ）にマッピングします。注：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 |
invalid_input | 400不正なリクエスト (無効な入力) | エラー |
bad_link | 400不正なリクエスト (不正なリンク) | エラー |
internal_server_error | 500内部サーバーエラー（不明なエラー） | エラー |
service_unavailable | 503サービスは利用できません | エラー |
Booking API
| Test ヘッダーの値 | HTTP コードとレスポンス | ステータス |
|---|---|---|
| スタンダード | 200 OK (標準成功レスポンス) | Success |
invalid_input | 400不正なリクエスト (無効な入力) | エラー |
bad_link | 400不正なリクエスト (不正なリンク) | エラー |
price_mismatch | 409コンフリクト（価格の不一致） | エラー |
sold_out | 409コンフリクト（完売） | エラー |
internal_server_error | 500内部サーバーエラー（不明なエラー） | エラー |
service_unavailable | 503サービスは利用できません | エラー |
ユースケース別エンドポイントサマリー
| 使用例 | 方法と経路 | 必須クエリパラメータ / コメント |
|---|---|---|
| 地域体験 | GET /regions/{region_id}/experiences | language |
| 地域活動グループ | GET /regions/{region_id}/activity-groups | language |
| 地域活動 | GET /regions/{region_id}/activities | language |
| 体験コンテンツ | GET /experiences/content | experience_id[]、language |
| 活動グループの内容 | GET /experiences/activity-groups/content | language、activity_group_id[] |
| 活動内容 | GET /experiences/activities/content | activity_id[]、language |
| 活動時間 | GET /experiences/activities/{activity_id}/operating-hours | start_date``end_date(90日以下)、language |
| 経験カテゴリー | GET /experiences/categories | language、pagination_size |
| 経験属性 | GET /experiences/attributes | language、pagination_size |
| 活動カテゴリー | GET /experiences/activities/categories | language、pagination_size |
| アクティビティ属性 | GET /experiences/activities/attributes | language、pagination_size |
| 口コミ | GET /experiences/activities/{activity_id}/guest-reviews | limit、sort |
| 在庫と価格設定 | GET /experiences/activities/availability | activity_id[]``start_date,end_date (≤14),currency、language |
| カレンダーの空室状況 | GET /experiences/activities/calendars/availability | activity_id[]``start_date、end_date |
| 料金チェック | GET /experiences/activities/{activity_id}/price-check | token (ショッピングAPIコールより）、 tickets |
| 予約の作成 | POST /itineraries/activity | クエリー token (ショッピングAPIコールから）、 Body: CreateItineraryRequest,affiliate_reference_id,payment_token、primary_traveler |
| 旅程IDで検索 | GET /itineraries/{itinerary_id}/activity | — |
| アフィリエイト参照による検索 | GET /itineraries/activity | affiliate_reference_id |
| 予約のキャンセル | DELETE /itineraries/{itinerary_id}/activity | 204(予約は正常にキャンセルされました)、202 (状態不明) |
| バウチャーを取得 | GET /itineraries/{itinerary_id}/activity/voucher | 予約したアクティビティのバウチャーを取得するためのリンクを返します。 |
注： パラメータの後に[] が続く場合は、comma-separated配列に複数の値を持つことができることを示します。
API の詳細
このページでactivity-relatedのエンドポイント定義を調べ、Postmanのようなテストソフトを使って、例とスキーマ定義が実際の出力と比較してどうなのかを理解しましょう。このAPIが試験段階を過ぎたら、そのエンドポイントも私たちのAPI Explorer。