Rapid Car APIの概要
end-to-endレ ンタカー予約
Car APIバンドル
Rapid Car APIは、Expedia Group's印象的なレンタカー在庫を利用したend-to-endレンタカー予約を可能にし、旅行者により総合的な体験を提供します。190カ国以上の47,000のベンダーにアクセスできるため、パートナーはサービス内容を大幅に拡大し、予約を増やすことができます。弊社 API のモジュールにより、ビジネスのニーズに合わせて旅行予約プロセスを簡単にカスタマイズできます。
当社のエンドポイントは、開発者にレンタカーサービスへの包括的なアクセスを提供し、すべてのロケーションで利用可能な車の検索、料金の詳細と利用可能な特典の表示、支払い方法の登録、予約の作成、予約詳細の取得、およびキャンセルの実行などの機能を可能にします。/carsフローの全体像は以下をご覧ください：
エンドポイントを知る
本製品はまだ早期アクセス段階であるため、スキーマの詳細と機能はまだアクティブな開発中であり、パートナーへの本製品の完全なリリース前に変更される可能性があることにご留意ください。
| アクション | メソッド | REST URI | 結果 |
|---|---|---|---|
| 車の検索 | GET | /cars/availability | さまざまな条件、e.g. pick-up, drop-off,、検索半径に基づいて利用可能なさまざまなレンタカーを返します。回答には、レンタカーID、pick-up/drop-offの場所、車のタイプ、走行距離などの詳細が含まれます。 |
| 詳細を見る | GET | /cars/{car_rental_id}/details | 価格内訳、オプション、ポリシーなど、特定の車の詳細を返します。 |
| 予約時の支払い方法の登録 | POST | /payments | 予約作成リクエストの本文で使用される支払いトークンを返します。このエンドポイントは他のAPIとは異なります。 |
| 予約 | POST | /itineraries/car | 予約プロセスを完了します。 |
| 予約を検索します。 | GET | /itineraries/car | による予約の詳細を返しますaffiliate_reference。 |
| 旅程の取得 | GET | /itineraries/{itinerary_id}/car | 旅程の詳細は itinerary_id. |
| 予約をキャンセルする | DELETE | /itineraries/{itinerary_id}/car | 既存の予約をキャンセルします。 |
使用例
ここでは、Rapid Car APIを使用して、end-to-end予約体験を作成する方法を説明します。
ステップ1：完璧な車を探す
/cars/availabilityを利用して、顧客が場所と日時を指定して利用可能な車両を検索できるようにします。
注：返される結果の最大数は200です。
| キーパラメーター | 説明 | おすすめ |
|---|---|---|
pickup_time | レンタカーのピックアップ時間 | 拡張ISO 8601フォーマットで指定、e.g. 2018-02-12T11:59:00.000Z |
dropoff_time | レンタカーの乗り捨て時間 | 拡張ISO 8601フォーマット、e.g. 2018-02-12T11:59:00.000Z |
pickup_area | 半径と座標で指定された車のピックアップ場所。 | フォーマットはradius,latitude,longitude,e.g. 10,37.9838,23.7275です。pickup_areaまたはpickup_airport のどちらか一方のみが必要です。 |
dropoff_area | 車の降車場所は半径と座標で示されます。 | フォーマットはradius,latitude,longitude,e.g. 10,37.9838,23.7275です。dropoff_area、dropoff_airport のどちらか一方のみ使用可能。 |
pickup_airport | お迎えの空港です。 | pickup_areaまたはpickup_airport のどちらか一方のみが必要です。 |
dropoff_airport | お車をお預かりする空港です。 | dropoff_area、dropoff_airport のどちらか一方のみ使用可能。 |
driver_age | 運転者の年齢（30歳未満または70歳以上の場合）。 | 運転者の年齢がこれらのパラメータから外れている ことが示されない限り、デフォルト値の40を使用する必要があります。 |
currency | レートに使用する通貨。 | ISO 4217フォーマット、e.g. USD。 |
language | レスポンスに必要な言語。 | ISO639-1アルファ2の言語コードのみを使用してください。詳しくはこのリスト をご覧ください。 |
country_code | 旅行者の販売場所の国コード。 | ISO 3166-1 alpha-2フォーマットで指定。これは、取引が行われる国を表す必要があります。 |
rental_company | レンタル会社によるフィルタリングが可能です。 | rental_companyクエリーパラメーターを複数回繰り返すことで、最大20社のレンタル会社を指定できます。 |
ステップ2：詳細
/cars/{car_rental_id}/detailsエンドポイントを使用して、価格内訳やポリシーなどの追加車両情報を取得します。
ステップ3：顧客が選択した支払い方法に関する情報を取得します。
これで、payments エンドポイントを使用して、顧客が予約の支払い方法を登録できるようになります。
レスポンスにはpayment_token、予約作成リクエストのボディに入ります。
ステップ4：予約の作成
/cars/{car_rental_id}/detailsレスポンスは、支払いセッションを完了し、予約を作成するためのリンクを返します。/itineraries/car、予約が完了します。
ステップ5：予約の取得
予約の詳細を取得するには、/itineraries/{itinerary_id}/car エンドポイントを呼び出して確認IDを取得します。