Rapid Car APIの概要
end-to-endでのレンタカー予約を確実に実現する
Car APIバンドル
Rapid Car APIは、Expedia Group'sの充実したレンタカー在庫を基盤として、end-to-endでのレンタカー予約を可能にし、旅行者にさらに包括的な体験を提供します。190カ国以上にわたる47,000社のベンダーと提携することで、パートナー各社は提供サービスを大幅に拡充し、予約数を増やすことができます。弊社 API のモジュールにより、ビジネスのニーズに合わせて旅行予約プロセスを簡単にカスタマイズできます。
当社のエンドポイントにより、開発者の皆様はレンタカーサービスに包括的にアクセスできるようになり、すべての拠点での空車検索、料金の詳細や利用可能なオプションの確認、支払い方法の登録、予約の作成、予約詳細の照会、キャンセル手続きなどの機能をご利用いただけます。
Car APIにおける旅行者とのやり取り
エンドポイントについて理解を深めましょう
本製品は現在、アーリーアクセス段階にあるため、スキーマの詳細や機能については現在も開発が進められており、パートナー様への正式リリースまでに変更される可能性があることをあらかじめご了承ください。
| アクション | メソッド | REST URI | 結果 |
|---|---|---|---|
| 車の検索 | GET | /cars/availability | e.g. pick-up, drop-off, や検索範囲など、さまざまな条件に基づいて利用可能なレンタカーを一覧表示します。1回のリクエストにつき最大200台まで表示されます。この回答には、レンタカーのID、pick-up/drop-offの店舗、車種、走行距離などの詳細が含まれています。 |
| 詳細をご覧ください | GET | /cars/{car_rental_id}/details | 特定の車の詳細（価格の内訳、オプション装備、および保証内容など）を返します。 |
| ご予約のお支払い方法を登録してください | POST | /payments | 「create booking」リクエストの本文に含める支払いトークンを返します。このエンドポイントは、他の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. 2027-02-12T11:59:00となります。 |
dropoff_time | レンタカーの返却時間です。 | 拡張ISO 8601形式で表記すると、e.g. 2027-02-12T11:59:00となります。 |
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歳以上である場合。 | 管轄区域に特定の要件がない限り、運転者の年齢が30歳未満または70歳以上でない場合は、デフォルト値を40とすることをお勧めします。 |
currency | 料金の表示に使用する通貨です。 | ISO 4217形式で表記すると、e.g. 米ドルとなります。 |
language | 応答に使用する言語。 | 言語形式には、ISO 639-1の2文字の言語コードと、BCP-47の2文字のロケールコードを使用する必要があ ります。 >> Rapidがサポートするすべての言語を見る |
country_code | 旅行者の購入先の国コードです。 | ISO 3166-1アルファ-2形式で表記されています。これは、取引が行われている国を表すものとなります。 |
traffic_profile | 検索に使用されたサイトのバージョン（例：Web版かアプリ版か） | サイトの設定を行う際、この文字列値の設定をお手伝いいたします。 |
ステップ2：詳細を確認する
/cars/{car_rental_id}/detailsエンドポイントを使用して、価格の内訳や保険契約内容など、車両に関する追加情報を取得してください。
ステップ3：お客様から、ご希望のお支払い方法に関する情報を伺います
paymentsエンドポイントを使用することで、お客様が予約に対して支払い方法を登録できるようになりました。
レスポンスには、予約作成リクエストの本文に含める「payment_token」が含まれます。
ステップ4：予約を作成する
/cars/{car_rental_id}/detailsのレスポンスには、支払い手続きを完了し、予約を作成するためのリンクが返されます。/itineraries/carエンドポイントを使用すると、予約を完了させる ことができます。
ステップ5：予約情報を確認する
予約の詳細を取得するには、/itineraries/{itinerary_id}/car エンドポイントにリクエストを送信して、エクスペディアによって設定された確認IDを取得するか、/itineraries/car?affiliate_reference_id={affiliateReferenceId} にリクエストを送信して、お客様側で割り当てられたIDを取得してください。