ラピッドアクティビティAPIの概要
Rapid Activities APIを使って、お客様に本格的なアクティビティを予約してもらいましょう。
アーリーアクセス・プレビュー
このドキュメントは、選ばれたパートナーだけを対象とした早期アクセス・プレビュー・イニシアチブの一部です。パイロットプログラムは2025年第4四半期までに開始され、2026年に一般提供が開始される予定です。
パイロット版またはベータ版パートナーにご興味のある方は、アカウントマネージャーまでご連絡ください。
Rapid Activities APIは、簡単に統合できるend-to-end予約パスを介して旅行者にアクティビティや体験を提供できるように設計されています。これにより、旅行者により総合的な予約体験を提供すると同時に、新たな収益源を確保することができます。
アクティビティ予約フローの構築
アクティビティAPIとの統合と予約パスの構築の概要は以下の通りです。Rapid Activities APIは、search-to-bookのフローを実現するエンドポイントから構成されています。
注: この製品はまだ早期アクセス段階であるため、スキーマの詳細と機能はまだアクティブな開発中であり、パートナーにこの製品を完全にリリースする前に変更される可能性があることにご留意ください。
1.利用可能なアクティビティを検索
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.選択したアクティビティのオファーを表示
offersエンドポイントでは、時間、料金、ツアーの空き状況など、選択したアクティビティで利用可能なオファーの詳細を旅行者に提供します。
旅行者が予約する前に知っておくべき詳細がここにあります:
| エンドポイント | それを使って... |
|---|---|
callouts | 予約前にアクティビティに関する重要な情報を顧客に提供しましょう。 |
inclusions | アクティビティに含まれるすべての機能の概要を説明してください。 |
exclusions | アクティビティに含まれていない機能のリストを提供してください。 |
3.価格を確認し、お支払いの詳細を提供します。
旅行者が完璧なバケーション体験を見つけたら、offer_id のエンドポイントを使用して、価格と必要な予約情報を確認します。
4.旅行者が選択した支払い方法に関する情報の取得
これで、payments エンドポイントを使用して、顧客が予約の支払い方法を登録できるようになります。レスポンスにはpayment_token、予約作成リクエストのボディに入ります。
5.予約の作成
予約を作成するには、activity エンドポイントを使用します。このエンドポイントは、関連するすべての操作リンクを持つitinerary_id を返します。
6.予約詳細の取得
activityエンドポイントを使用すると、旅程IDを使用して予約の詳細を取得できます。回答には、該当する場合、キャンセルリンクが含まれます。
API の詳細
このページでactivity-relatedのエンドポイント定義を調べ、テスト・ソフトウェアを使用して、例とスキーマ定義が実際の出力とどのように比較されるかを理解します。このAPIが試験段階を過ぎたら、そのエンドポイントも私たちのAPI Explorer。