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,, 검색 반경)에 따라 이용 가능한 렌터카 목록을 반환하며, 요청당 최대 200대의 차량을 반환합니다. 이 응답에는 렌터 카 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. 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. USD입니다. |
language | 응답에 사용될 언어를 지정합니다. | 언어 형식은 ISO 639-1 2자리 언어 코드와 BCP-47 2자리 로케일 코드를 함께 사용해야 합니다. >> Rapid에서 지원하는 모든 언어 보기 |
country_code | 여행자의 결제 장소에 해당하는 국가 코드. | ISO 3166-1 알파-2 형식으로 표기됩니다. 이는 거래가 이루어지는 국가를 나타내야 합니다. |
traffic_profile | 검색에 사용된 귀하의 사이트 버전(예: 웹 대 앱) | 사이트를 설정하실 때 이 문자열 값을 설정하도록 도와드리겠습니다. |
2단계: 세부 정보 확인하기
/cars/{car_rental_id}/details엔드포인트를 사용하여 가격 내역 및 보험 약관 등 추가 차량 정보를 조회할 수 있습니다.
3단계: 고객이 선택한 결제 수단에 대한 정보를 확인합니다.
이제 payments 엔드포인트를 사용하여 고객이 예약에 대한 결제 수단을 등록할 수 있도록 할 수 있습니다.
응답에는 예약 생성 요청의 본문에 포함될 예약 요청 객체( payment_token)가 포함됩니다.
4단계: 예약 생성하기
/cars/{car_rental_id}/details응답은 결제 절차를 완료하고 예약을 생성할 수 있는 링크를 반환합니다. /itineraries/car엔드포인트를 사용하면 예약을 완료할 수 있습니다.
5단계: 예약 내역 조회하기
예약 내역을 조회하려면, Expedia에서 설정한 확인 ID를 가져오려면 /itineraries/{itinerary_id}/car 엔드포인트를 호출하거나, 귀사에서 할당된 ID를 가져오려면 /itineraries/car?affiliate_reference_id={affiliateReferenceId} 엔드포인트를 호출하십시오.