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を取得してください。