API de resumo de itinerário

Orientações e exemplos para acessar a API de resumo de itinerário

A API de resumo de itinerário permite que um parceiro consulte todos os itinerários que foram reservados em uma única conta de usuário da Expedia.

Ponto de extremidade

Método	Ponto de extremidade
GET	https://apim.expedia.com/bookings

Cabeçalhos obrigatórios

Key:	Chave de API da Expedia
Authorization:	Sequência de autorização de API da Expedia
User-Id:	nomedeusuário@domínio.com
Accept:	application/vnd.exp-booking.v3+json
Partner-Transaction-Id:	Sequência TransactionID do parceiro

Cabeçalhos opcionais

Senha:

[Senha da conta Expedia] Inclua se a reserva for feita com uma conta de usuário da Expedia. Deixe em branco para reservar como usuário convidado.

Próximos passos

O usuário pode se vincular com o site da Expedia para visualizar o itinerário.
O usuário pode usar a consulta de API opcional para acessar os dados do itinerário.

Exemplo de consulta de API de resumo de itinerário

URL da solicitação

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

Resposta

{
	"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"
				}
			}
		}
	]
}

Códigos de aviso

Códigos de aviso comuns

Código de aviso	Resposta de aviso	Causa
MAX_LIMIT_EXCEEDED	O número máximo de itinerários que podem ser recuperados foi excedido. Limite permitido: 100.	O número de itinerários excedeu o número máximo de itinerários que podem ser recuperados pelo sistema. Filtre os resultados.
INVALID_TRIP_LIMIT	O limite da viagem é inválido. Os valores aceitos são números do intervalo [1 - 100].	O valor do parâmetro de URL 'Limit' não era de tipo válido. Ele precisa ser um número válido dentro do intervalo mencionado. Os resultados serão reunidos com base no limite do sistema
PARTIAL_RESULTS_DISPLAYED	Mostrando 100 itinerários de 216.	Os critérios de busca estavam retornando mais resultados do que o esperado. A mensagem vai informar o usuário se houver algum resultado não mostrado na resposta.

Códigos de erro

Códigos de erro comuns

Código de status HTTP	Código de erro	Resposta de erro	Causa
400	INVALID_TRIP_START_DATE	A data inicial está em formato inválido. O formato válido é AAAA-MM-DD.	A data inicial inserida não estava no formato definido.
400	INVALID_TRIP_END_DATE	A data final está em formato inválido. O formato válido é AAAA-MM-DD.	A data final inserida não estava no formato definido.
400	START_DATE_LATER_THAN_END_DATE	A data inicial deve ser anterior à data final.	A data inicial deve vir antes da data final.
400	INVALID_TRIP_STATUS	O status da viagem é inválido. Ele deve ser [BOOKED/CANCELED/PENDING/SAVED].	Use um status de viagem válido entre os valores mencionados.

Aqui você pode explorar as definições de ponto de extremidade para essa API e acessar o API Explorer para testar todos os pontos de extremidade da XAP, baixar especificações OpenAPI ou baixar as nossas coleções Postman. Teste uma ou todas essas opções para entender como os exemplos e as definições de esquema se comparam com o resultado real.