This is an auto-generated translation

API de links de voos

Orientações e exemplos para acessar a API de links de voos

Com a API de links de voos, você pode enviar dados de voos que coincidam com o inventário da Expedia e receber links para a API de detalhes da XAP e/ou para a página de detalhes do site da Expedia.

Ponto de extremidade

MétodoPonto de extremidade
POSThttps://apim.expedia.com/flights/links

Cabeçalhos obrigatórios

Key:Chave de API da Expedia
Authorization:Sequência de autorização de API da Expedia
Content-Type:application/json
Accept:application/vnd.exp-flight.v3+json
Partner-Transaction-Id:Sequência TransactionID do parceiro

Próximos passos

  • Deeplink para a página de detalhes do site da Expedia e acesso à página de reservas.
  • Consulte a API de detalhes de voo para mais informações sobre a consulta da API de voos e reservas.

https://apim.expedia.com/flights/links
{
	"Flights": [{
			"FlightId": "abc",
			"SplitTicket": false,
			"Segments": [{
				"FareType": "PUBLISHED",
				"Provider": "Amadeus",
				"LowCost": false,
				"Legs": [{
						"DepartureAirport": {
							"Code": "COK"
						},
						"ArrivalAirport": {
							"Code": "DOH"
						},
						"DepartureDateTime": "2021-06-06T03:35:00+05:30",
						"ArrivalDateTime": "2021-06-06T05:35:00+03:00",
						"FlightNumber": "517",
						"MarketingAirlineCode": "QR",
						"BookingCode": "W",
						"CabinClass": "ECONOMY"
					},
					{
						"DepartureAirport": {
							"Code": "DOH"
						},
						"ArrivalAirport": {
							"Code": "ORD"
						},
						"DepartureDateTime": "2021-06-06T08:50:00+03:00",
						"ArrivalDateTime": "2021-06-06T14:55:00-05:00",
						"FlightNumber": "725",
						"MarketingAirlineCode": "QR",
						"BookingCode": "W",
						"CabinClass": "ECONOMY"
					}
				]
			}],
			"TotalPrice": {
				"Value": "2576.68",
				"Currency": "USD"
			}
		},
		{
			"FlightId": "def",
			"SplitTicket": false,
			"Segments": [{
				"FareType": "PUBLISHED",
				"Provider": "Sabre",
				"LowCost": false,
				"Legs": [{
						"DepartureAirport": {
							"Code": "COK"
						},
						"ArrivalAirport": {
							"Code": "AUH"
						},
						"DepartureDateTime": "2021-06-06T21:25:00+05:30",
						"ArrivalDateTime": "2021-06-06T23:55:00+04:00",
						"FlightNumber": "6528",
						"MarketingAirlineCode": "9W",
						"BookingCode": "H",
						"CabinClass": "ECONOMY"
					},
					{
						"DepartureAirport": {
							"Code": "AUH"
						},
						"ArrivalAirport": {
							"Code": "ORD"
						},
						"DepartureDateTime": "2021-06-07T03:20:00+04:00",
						"ArrivalDateTime": "2021-06-07T08:55:00-05:00",
						"FlightNumber": "6405",
						"MarketingAirlineCode": "9W",
						"BookingCode": "H",
						"CabinClass": "ECONOMY"
					}
				]
			}],
			"TotalPrice": {
				"Value": "3266.52",
				"Currency": "USD"
			}
		}
	],
	"Passengers": {
		"Adult": "1",
		"Senior": "1",
		"ChildrenAges": "2,14"
	},
	"Links": [
		"WD",
		"AD"
	]
}
{
	"Links": [{
			"FlightId": "abc",
			"WebDetails": {
				"Method": "GET",
				"Href": "https://www.expedia.com/go/udp?CCheck=1&piid=~null.S~AQoCCAASCAjUBBABGI8KIAEgDCAHIA0oAg~AQpCCh8I0aQBEgM1MTcYwlMgwzsozbGLATDbs4sBOFdAAFgBCh8I0aQBEgM3MjUYwzsgrhwonrWLATDru4sBOFdAAFgBEgYIARABGAEYBCIECAEQASIECAMQASIECAIQAigCMAI&DepartureTLA=L1:COK&ArrivalTLA=L1:ORD&DepartureDate=L1:2021-06-06&ArrivalDate=L1:2021-06-06&NumAdult=1&NumSenior=1&NumChild=2&ChildrenAges=2|14&Sort=10&TripType=OneWay&ProductType=air&eapid=0-1&ServiceVersion=V5&MessageGuid=a79898d0-3bc2-11e8-a98c-4ccc6a3c3f78&langid=1033"
			},
			"ApiDetails": {
				"Accept": "application/vnd.exp-flight.v3+json",
				"Method": "GET",
				"Href": "http://apim.expedia.com/flights/details/~null.S~AQoCCAASCAjUBBABGI8KIAEgDCAHIA0oAg~AQpCCh8I0aQBEgM1MTcYwlMgwzsozbGLATDbs4sBOFdAAFgBCh8I0aQBEgM3MjUYwzsgrhwonrWLATDru4sBOFdAAFgBEgYIARABGAEYBCIECAEQASIECAMQASIECAIQAigCMAI?price=2576.68&childrenAges=2%2C14"
			}
		},
		{
			"FlightId": "def",
			"WebDetails": {
				"Method": "GET",
				"Href": "https://www.expedia.com/go/udp?CCheck=1&piid=~null.S~AQoCCAASCAjUBBABGI8KIAEgDCAHIA0oAg~AQpECiAIua4BEgQ2NTI4GMJTIIA9KPu5iwEw67uLAThIQABYAQogCLmuARIENjQwNRiAPSCuHCi4vYsBMKPEiwE4SEAAWAESBggBEAEYARgEIgQIARABIgQIAxABIgQIAhACKAIwAg&DepartureTLA=L1:COK&ArrivalTLA=L1:ORD&DepartureDate=L1:2021-06-06&ArrivalDate=L1:2021-06-07&NumAdult=1&NumSenior=1&NumChild=2&ChildrenAges=2|14&Sort=10&TripType=OneWay&ProductType=air&eapid=0-1&ServiceVersion=V5&MessageGuid=a79898d0-3bc2-11e8-a98c-4ccc6a3c3f78&langid=1033"
			},
			"ApiDetails": {
				"Accept": "application/vnd.exp-flight.v3+json",
				"Method": "GET",
				"Href": "http://apim.expedia.com/flights/details/~null.S~AQoCCAASCAjUBBABGI8KIAEgDCAHIA0oAg~AQpECiAIua4BEgQ2NTI4GMJTIIA9KPu5iwEw67uLAThIQABYAQogCLmuARIENjQwNRiAPSCuHCi4vYsBMKPEiwE4SEAAWAESBggBEAEYARgEIgQIARABIgQIAxABIgQIAhACKAIwAg?price=3266.52&childrenAges=2%2C14"
			}
		}
	]
}

Códigos de erro

Códigos de erro comuns

Código de status HTTPCódigo de erroResposta de erroCausa
200FLIGHT_NOT_AVAILABLEO voo solicitado não está disponível.Em uma busca ancorada, se há segmentos selecionados na oferta que expiraram enquanto a busca ancorada é realizada no próximo segmento.
200CHILD_PRICED_AS_ADULTUma criança da faixa etária de 12 a 17 anos na solicitação tem o mesmo preço que um adulto na resposta.Qualquer criança da faixa etária de 12 a 17 anos vai receber o preço de adulto, e essa mensagem de aviso vai aparecer para indicar isso.
200INVALID_WD_PASSENGER_COMBINATIONO link não aceita busca com bebês no colo e no assento na mesma consulta.Quando o link WD for solicitado, ele será retornado somente quando um bebê no assento e um bebê no colo não forem solicitados ao mesmo tempo.
200INVALID_WD_PASSENGER_COUNTO link não aceita uma busca com mais de 6 passageiros.Quando o link WD for solicitado, o deeplink será retornado somente quando o número de passageiros solicitados for menor ou igual a 6.
409NO_RESULTS_FOUNDNenhuma solução de voos foi encontrada para a solicitação.Não há voos para um critério solicitado durante a API de busca de voos.
200NO_RESULTS_FOUNDNenhuma solução de voos foi encontrada para a solicitação.Não há voos para os critérios selecionados.
500FLIGHT_LINKS_NOT_AVAILABLEOs links de voos solicitados não está disponível.Ocorreu um erro interno do aplicativo para os serviços de chamada de solicitação.
500SERVER_ERROROcorreu um erro ao processar a solicitação.Há um problema no servidor que resultou em falha.
400INVALID_ACCEPT_HEADERForneça um cabeçalho Accept válido.O cabeçalho Accept fornecido não está em conformidade com a documentação.
400MISSING_ADULT_OR_SENIORInformações do passageiro inválidas: especifique, pelo menos, 1 passageiro adulto ou idoso.Nenhum passageiro adulto ou idoso foi especificado na solicitação.
400INVALID_ADULT_COUNTFoi fornecido um número de adultos inválido. Forneça um número de adultos válido.Foi especificado um número de adultos inválido na solicitação.
400INVALID_SENIOR_COUNTFoi fornecido um número de idosos inválido. Forneça um número de idosos válido.Foi especificado um número de idosos inválido na solicitação.
400INVALID_INFANT_IN_LAP_COUNTFoi fornecido um número de bebês no colo inválido. Forneça um número de bebês no colo válido.Foi especificado um número de bebês no colo inválido na solicitação.
400INVALID_INFANT_IN_SEAT_COUNTFoi fornecido um número de bebês no assento inválido. Forneça um número de bebês no assento válido.Foi especificado um número de bebês no assento inválido na solicitação.
400INVALID_PASSENGER_COUNTInformações do passageiro inválidas: o número total de passageiros deve estar entre 1 e 9, inclusive.Foi especificado um número inválido de passageiros na solicitação.
400INFANT_IN_LAP_ACCOMPANIED_BY_ADULT_OR_SENIORInformações do passageiro inválidas: cada bebê no colo deve estar na companhia de uma pessoa adulta ou idosa.O número de bebês no colo solicitado é maior que o número de adultos e idosos solicitado.
400INVALID_CHILD_AGEInformações do passageiro inválidas: a idade da criança deve estar entre 2 e 17 anos.A idade da criança solicitada não está entre 2 e 17 anos.
400NO_FLIGHTS_REQUESTEDNão foram encontrados detalhes do voo na solicitação.Não foram fornecidos detalhes do voo na solicitação.
400NO_FLIGHTS_REQUESTEDNão foram encontrados detalhes do voo na solicitação.Não foram encontrados detalhes do voo na solicitação de links.
400FLIGHT_ID_REQUIREDFlightId está ausente na solicitaçãoO FlightId é obrigatório para o detalhe de cada voo na solicitação.
400TOTAL_PRICE_REQUIREDAo solicitar o link AD, o preço total em FlightId abc deve ser especificado.O preço total é um elemento obrigatório durante a solicitação do deeplink ApiDetails.
400MISSING_SEGMENT_DETAILSInformações de segmento ausentes para FlightId abc.As informações do segmento na solicitação estão ausentes ou incompletas.
400MISSING_FARE_TYPEFareType está ausente no segmento de número 1 de FlightId abc.O tipo de tarifa está ausente em um segmento na solicitação.
400MISSING_LEG_DETAILSInformações de trecho ausentes para FlightId abc e segmento de número 1.Os detalhes do trecho estão ausentes em um segmento na solicitação
400MISSING_FLIGHT_NUMBERFlightNumber está ausente no trecho de número 1 do segmento de número 1.FlightNumber está ausente em um segmento na solicitação.
400MISSING_ARRIVAL_CODEArrivalAirportCode está ausente no trecho de número 1 do segmento de número 1 para FlightId abc.ArrivalAirportCode está ausente em um trecho da solicitação.
400MISSING_BOOKING_CODEBookingCode está ausente no trecho de número 1 do segmento de número 1 para FlightId abc.BookingCode está ausente em um trecho da solicitação.
400MISSING_CABIN_CLASSCabinClass está ausente no trecho de número 1 do segmento de número 1 para FlightId abc.CabinClass está ausente em um trecho da solicitação.
400MISSING_ARRIVAL_CODEArrivalAirportCode está ausente no trecho de número 1 do segmento de número 1 para FlightId abc.O código do aeroporto de chegada está ausente em um trecho da solicitação.
400MISSING_ARRIVAL_DATE_TIMEArrivalDateTime está ausente no trecho de número 1 do segmento de número 1 para FlightId abc.ArrivalDateTime está ausente em um trecho da solicitação.
400MISSING_DEPARTURE_CODEDepartureAirportCode está ausente no trecho de número 1 do segmento de número 1 para FlightId abc.O código do aeroporto de partida está ausente em um trecho da solicitação.
400MISSING_DEPARTURE_DATE_TIMEDepartureDateTime está ausente no trecho de número 1 do segmento de número 1 para FlightId abc.DepartureDateTime está ausente em um trecho da solicitação.
400INVALID_FLIGHT_LINKSOs links especificados na solicitação DD são inválidos.Apenas WD e AD são os links aceitos na solicitação.

Detalhes da API

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.


Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.