일정 요약 API

일정 요약 API 액세스에 대한 지침 및 예시

일정 요약 API를 사용하면 파트너는 단일 Expedia 사용자 계정에 예약된 모든 일정을 쿼리할 수 있습니다.

엔드포인트

메서드엔드포인트
GEThttps://apim.expedia.com/bookings

필수 헤더

Key:Expedia API 키
Authorization:Expedia API 승인 문자열
User-Id:username@domain.com
Accept:application/vnd.exp-booking.v3+json
Partner-Transaction-Id:파트너 거래 ID 문자열

선택적 헤더

비밀번호:[Expedia 계정 비밀번호] Expedia 사용자 계정으로 예약한 경우 포함합니다. 비회원 예약의 경우 비워 둡니다.

다음 단계

  • 사용자는 Expedia 웹사이트에 연결하여 일정을 볼 수 있습니다.
  • 사용자는 API 쿼리(옵션)를 사용하여 일정 데이터에 액세스할 수 있습니다.

일정 요약 API 쿼리 예시

요청 URL

https://apim.expedia.com/bookings?status=BOOKED,SAVED&startDate=2021-06-01&endDate=2021-06-02&limit=10

응답

{
	"Warnings": [{
		"MAX_LIMIT_EXCEEDED": "The maximum number of itineraries that can be retrieved exceeded. Allowed Limit: 100."
	}],
	"TransactionId": "f06edfa3-27f4-44e6-838c-b8dd3d0a3210",
	"Itineraries": [{
			"Title": "Hotel & Air Package",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T02:51:33.320Z",
			"Entities": [{
					"ProductType": "HOTEL",
					"BookingStatus": "BOOKED",
					"StartDateTime": "2021-06-23T08:00:00-08:00",
					"EndDateTime": "2021-06-26T08:00:00-08:00"
				},
				{
					"ProductType": "FLIGHT",
					"BookingStatus": "BOOKED",
					"StartDateTime": "2021-06-08T22:00:00-08:00",
					"EndDateTime": "2021-06-10T22:00:00-08:00"
				}
			],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/packages/bookings/71184721958"
				}
			},
			"TotalCommission": {
				"Value": "68.80",
				"Currency": "USD"
			}
		},
		{
			"Title": "Hotel Booking",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T08:00:00-08:00",
			"Entities": [{
				"ProductType": "HOTEL",
				"BookingStatus": "BOOKED",
				"StartDateTime": "2021-06-23T08:00:00-08:00",
				"EndDateTime": "2021-06-26T08:00:00-08:00"
			}],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/hotels/bookings/71184721958"
				}
			}
		},
		{
			"Title": "Car Booking",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T08:00:00-08:00",
			"Entities": [{
				"ProductType": "CAR",
				"BookingStatus": "BOOKED",
				"StartDateTime": "2021-06-09T08:00:00-08:00",
				"EndDateTime": "2021-06-10T08:00:00-08:00"
			}],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/cars/bookings/71184721958"
				}
			}
		},
		{
			"Title": "Air Booking",
			"TripNumber": "1234567866",
			"CreateDateTime": "2021-06-17T08:00:00-08:00",
			"Entities": [{
				"ProductType": "FLIGHT",
				"BookingStatus": "BOOKED",
				"StartDateTime": "2021-06-08T08:00:00-08:00",
				"EndDateTime": "2021-06-10T08:00:00-08:00"
			}],
			"Links": {
				"WebItinRetrieve": {
					"Href": "https://www.expedia.com/1234567"
				},
				"ApiItinRetrieve": {
					"Accept": "application/vnd.exp-booking.v3+json",
					"Method": "GET",
					"Href": "https://apim.expedia.com/airs/bookings/71184721958"
				}
			}
		}
	]
}

경고 코드

일반적인 경고 코드

경고 코드경고 대응원인
MAX_LIMIT_EXCEEDED검색할 수 있는 최대 일정 수를 초과했습니다. 허용되는 한도: 100.일정 수가 시스템에서 검색할 수 있는 최대 itin 수를 초과했습니다. 결과를 필터링해 주세요.
INVALID_TRIP_LIMIT여행 한도가 잘못되었습니다. 허용되는 값은 [1 - 100] 범위의 숫자입니다.'Limit'의 URL 매개변수 값이 유효한 유형이 아닙니다. 언급된 범위 사이의 유효한 숫자여야 합니다. 결과는 시스템 한도에 따라 가져옵니다.
PARTIAL_RESULTS_DISPLAYED일정 216개 중 100개를 표시합니다.검색 조건이 예상보다 더 많은 결과를 제공했습니다. 응답에 표시되지 않은 결과가 있는 경우 메시지를 통해 사용자에게 알려줍니다.

오류 코드

일반적인 오류 코드

HTTP 상태 코드오류 코드오류 응답원인
400INVALID_TRIP_START_DATE시작 날짜의 형식이 잘못되었습니다. 유효한 형식은 YYYY-MM-DD입니다.입력한 시작 날짜가 정의된 형식이 아닙니다.
400INVALID_TRIP_END_DATE종료 날짜의 형식이 잘못되었습니다. 유효한 형식은 YYYY-MM-DD입니다.입력한 종료 날짜가 정의된 형식이 아닙니다.
400START_DATE_LATER_THAN_END_DATE시작 날짜는 종료 날짜 이전이어야 합니다.시작 날짜는 종료 날짜 이전에 와야 합니다.
400INVALID_TRIP_STATUS여행 상태가 잘못되었습니다. 상태는 [예약됨/취소됨/보류 중/저장됨]이 되어야 합니다.언급된 값 중 유효한 여행 상태를 사용해 주세요.

API 세부 정보

여기에서 이 API에 대한 엔드포인트 정의를 탐색한 다음 API Explorer로 이동하여 모든 XAP 엔드포인트를 사용해 보거나, OpenAPI 사양을 다운로드하거나, Postman 컬렉션을 다운로드할 수 있습니다. 이러한 옵션 중 하나 또는 모두를 사용하여 테스트하면 예시 및 스키마 정의가 실제 출력과 어떻게 비교되는지 이해할 수 있습니다.


이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 만드는 데 도움을 주셔서 감사합니다!