ラピッドアクティビティAPI試験運用ドキュメント
アーリーアクセス・プレビュー
このドキュメントは、選ばれたパートナーだけを対象とした早期アクセス・プレビュー・イニシアチブの一部です。パイロット・プログラムは2025年第3四半期までに開始され、2026年に一般提供が開始される予定です。
パイロット版またはベータ版パートナーにご興味のある方は、アカウントマネージャーまでご連絡ください。
最近の証拠 によると、旅行者はますます物質的な所有物よりも本物の体験を求めるようになっており、これはpre-Covid, のケースであったとはいえ、post-pandemicの世界ではなおさらです。Rapid Activities APIは、簡単に統合できるend-to-end予約経路を通じて、パートナーがアクティビティや体験を顧客に提供できるように設計されています。これにより、顧客はより総合的な予約体験を得ることができ、パートナーは新たな収益源を確保することができます。
Rapid /activities APIバンドル
ラピッド・アクティビティは、search-to-bookの流れを可能にするエンドポイントの選択で構成されています。
本製品はまだ早期アクセス段階であるため、スキーマの詳細と機能はまだ開発中であり、パートナーへの本製品の完全なリリース前に変更される可能性があることをご留意ください。
以下はその主なエンドポイント：
| アクション | メソッド | レストURI | 結果 |
|---|---|---|---|
| アクティビティ検索 | GET | /活動/利用可能性 | 指定された場所と日付範囲に基づいて、利用可能なアクティビティや体験を検索します。 |
| 詳細を見る | GET | /アクティビティactivity_id}/offers | 選択したアクティビティのオファーを検索します。特定のアクティビティで利用可能なツアーなどの時間と料金を返します。 |
| 価格確認 | GET | /アクティビティactivity_id}/offers/{offer_id} | 要約された価格と必須の予約フィールドを返します。 |
| 予約時の支払い方法の登録 | POST | /支払い | 予約時に支払い方法を登録します。レスポンスには予約作成リクエストの本文にあるpayment_token。 |
| 予約の作成 | POST | /旅程/アクティビティ | 予約を作成します。このエンドポイントは、関連する操作リンクを持つitinerary_id を返します。 |
| 旅程IDで既存の予約の詳細をリクエスト | GET | /旅程itinerary_id}/activity | itinerary_idパラメータで旅程の詳細を返します。 |
| アクティビティ・ベンダーによる既存の予約の詳細をリクエストします。 | GET | /旅程/アクティビティ | affiliate_referenceパラメータに基づいて予約の詳細を返します。 |
| 予約のキャンセル | 削除 | /旅程itinerary_id}/activity | 既存の予約をキャンセルします。 |
使用例
Rapid Activities APIを使用して、end-to-end、お客様に予約体験を提供する方法をご紹介します。
ステップ1 - ご希望の場所で利用可能なアクティビティや体験を検索します。
/activities/availability エンドポイントを使用すると、旅行者は滞在中に目的地で利用できるアクティビティを確認できます。
以下の主要パラメータをご覧ください：
| キーパラメーター | 説明 | おすすめ |
|---|---|---|
start_date | 利用可能なアクティビティを検索するための開始日です。 | ISO 8601フォーマットを使用してください。例えば、2018-02-12. |
end_date | 利用可能な活動の検索終了日。 | ISO 8601フォーマットを使用してください。例えば、2018-02-12. |
currency | レートの通貨 | ISO 4217フォーマットを使用してください。例えば、米ドル。 |
language | 返答に必要な言語 | ISO639-1 alpha 2 言語コードと ISO3166-1 alpha 2 国コードのみ使用します。 |
country_code | 旅行者の販売場所の国コード。 | ISO 3166-1 alpha-2フォーマットを使用してください。これはショッピング取引が行われている国を表す必要があります。例えば、アメリカ。 |
region_id | 旅行者がアクティビティを探している場所や地域。 | 例えば、1122931. |
limit | レスポンスで返されるアクティビティの最大数。 | 最大：100 |
ステップ2 - ご希望のアクティビティで利用可能なオファーの詳細を入手します。
選択したアクティビティでどのようなオファーが利用可能か、お客様により詳しい情報を提供します。/activities/{activity_id}/offers エンドポイントは、そのアクティビティで利用できるツアーなどの時間と料金を返します。
旅行者が予約する前に知っておくべき詳細がここにあります：
| エンドポイント | それを使って... |
|---|---|
callouts | 予約前にアクティビティに関する重要な情報を顧客に提供しましょう。 |
inclusions | アクティビティに含まれるすべての機能の概要を説明してください。 |
exclusions | アクティビティに含まれていない機能のリストを提供してください。 |
ステップ3 - 価格を確認し、支払い詳細を入力します。
顧客が完璧なバケーション体験を見つけたら、/activities/{activity_id}/offers/{を使用します。offer_id} エンドポイントを使用して、現在の価格と必要な予約情報を検証します。
ステップ4：顧客が選択した支払い方法に関する情報の取得
/payments エンドポイントを使用して、顧客が予約の支払い方法を登録できるようになりました。レスポンスにはpayment_token、予約作成リクエストのボディに入ります。
ステップ5 - 予約の作成
/itineraries/activity エンドポイントを使用して予約を作成します。このエンドポイントは、関連するすべての操作リンクを持つitinerary_id を返します。
ステップ6 - 予約詳細の取得
/itineraries/{itinerary_id}/activity エンドポイントを使用して、旅程IDを使用して予約の詳細を取得することができます。回答には、該当する場合、キャンセルリンクが含まれます。
API の詳細
このページでactivity-relatedのエンドポイント定義を調べ、テスト・ソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。このAPIが試験段階を過ぎたら、そのエンドポイントも私たちのAPI Explorer。