API de calendario de tarifas de vuelos

Guía y ejemplos para acceder a la API de calendario de tarifas de vuelos

La API de calendario de tarifas de vuelos devolverá las tarifas más bajas para varios días, de modo que dichas tarifas puedan mostrarse fácilmente como calendario en el widget de reserva.

Punto de conexión

Método	Punto de conexión
GET	https://apim.expedia.com/flights/farecalendar

Encabezados obligatorios

Clave:	Clave de API de Expedia
Autorización:	Cadena de autorización de API de Expedia
Aceptar:	application/vnd.exp-flight.v3+json
Partner-Transaction-Id:	Cadena de TransactionID de colaborador

Encabezados opcionales

Accept-Encoding:	gzip más información sobre GZIP

Ejemplo de solicitud de calendario de tarifas

Solicitud de calendario de tarifas: solo ida

Solicitud

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&departureDate=2021-05-17

Respuesta

{
	"Offers": [{
			"DepartureDate": "2021-05-18",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "128.39",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-21",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "202.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-23",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "137.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-24",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "123.41",
					"Currency": "USD"
				}
			}
		}
	],
	"TransactionId": "0f2bc850-62bd-11ea-9e71-0aae9a66c99a"
}

Solicitud de calendario de tarifas: ida y vuelta

Solicitud: saliente

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&segment2.origin=SEA&segment2.destination=LAS&departureDate=2021-05-17&trip=outbound

Solicitud: entrante

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&segment2.origin=SEA&segment2.destination=LAS&departureDate=2021-05-17&trip=inbound

Respuesta

{
	"Offers": [{
			"DepartureDate": "2021-05-24",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "128.39",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-25",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "202.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDate": "2021-05-26",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "137.19",
					"Currency": "USD"
				}
			}
		},
		{
			"DepartureDateTime": "2021-05-27",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "123.41",
					"Currency": "USD"
				}
			}
		}
	],
	"TransactionId": "0f2bc850-62bd-11ea-9e71-0aae9a66c99a"
}

Solicitud de calendario de tarifas: con detalles del segmento

Solicitud

https://apim.expedia.com/flights/farecalendar?segment1.origin=LAS&segment1.destination=SEA&segment2.origin=SEA&segment2.destination=LAS&departureDate=2021-05-17&trip=inbound&includeSegmentDetails=true

Respuesta

{
	"Offers": [{
			"DepartureDate": "2021-05-24",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "128.39",
					"Currency": "USD"
				}
			},
			"Segments": [{
					"Legs": [{
						"DepartureAirport": {
							"Code": "LAS"
						},
						"ArrivalAirport": {
							"Code": "SEA"
						},
						"DepartureDateTime": "2021-05-24",
						"ArrivalDateTime": "2021-05-24",
						"FlightNumber": "1185",
						"MarketingAirlineCode": "UA",
						"OperatingCarrierCode": "UA",
						"CabinClass": "ECONOMY"
					}]
				},
				{
					"Legs": [{
						"DepartureAirport": {
							"Code": "SEA"
						},
						"ArrivalAirport": {
							"Code": "LAS"
						},
						"DepartureDateTime": "2021-06-08",
						"ArrivalDateTime": "2021-06-08",
						"FlightNumber": "1135",
						"MarketingAirlineCode": "UA",
						"OperatingCarrierCode": "UA",
						"CabinClass": "ECONOMY"
					}]
				}
			]
		},
		{
			"DepartureDate": "2021-05-25",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "202.19",
					"Currency": "USD"
				}
			},
			"Segments": [{
					"Legs": [{
							"DepartureAirport": {
								"Code": "LAS"
							},
							"ArrivalAirport": {
								"Code": "LAX"
							},
							"DepartureDateTime": "2021-05-25",
							"ArrivalDateTime": "2021-05-25",
							"FlightNumber": "505",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						},
						{
							"DepartureAirport": {
								"Code": "LAX"
							},
							"ArrivalAirport": {
								"Code": "SEA"
							},
							"DepartureDateTime": "2021-05-25",
							"ArrivalDateTime": "2021-05-25",
							"FlightNumber": "351",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						}
					]
				},
				{
					"Legs": [{
							"DepartureAirport": {
								"Code": "SEA"
							},
							"ArrivalAirport": {
								"Code": "LAX"
							},
							"DepartureDateTime": "2021-06-09",
							"ArrivalDateTime": "2021-06-09",
							"FlightNumber": "605",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						},
						{
							"DepartureAirport": {
								"Code": "LAX"
							},
							"ArrivalAirport": {
								"Code": "LAS"
							},
							"DepartureDateTime": "2021-06-09",
							"ArrivalDateTime": "2021-06-09",
							"FlightNumber": "451",
							"MarketingAirlineCode": "UA",
							"OperatingCarrierCode": "UA",
							"CabinClass": "ECONOMY"
						}
					]
				}
			]
		},
		{
			"DepartureDate": "2021-05-26",
			"OfferPrice": {
				"TotalPrice": {
					"Value": "137.19",
					"Currency": "USD"
				}
			},
			"Segments": [{
					"Legs": [{
						"DepartureAirport": {
							"Code": "LAS"
						},
						"ArrivalAirport": {
							"Code": "SEA"
						},
						"DepartureDateTime": "2021-05-26",
						"ArrivalDateTime": "2021-05-26",
						"FlightNumber": "142",
						"MarketingAirlineCode": "AS",
						"OperatingCarrierCode": "AS",
						"CabinClass": "ECONOMY"
					}]
				},
				{
					"Legs": [{
						"DepartureAirport": {
							"Code": "SEA"
						},
						"ArrivalAirport": {
							"Code": "LAS"
						},
						"DepartureDateTime": "2021-06-09",
						"ArrivalDateTime": "2021-06-09",
						"FlightNumber": "142",
						"MarketingAirlineCode": "AS",
						"OperatingCarrierCode": "AS",
						"CabinClass": "ECONOMY"
					}]
				}
			]
		}
	],
	"TransactionId": "0f2bc850-62bd-11ea-9e71-0aae9a66c99a"
}

Códigos de error

Códigos de error frecuentes

Código de estado HTTP	Código de error	Respuesta de error	Causa
400	INVALID_ACCEPT_HEADER	Proporciona un encabezado "Aceptar" válido.	El encabezado Aceptar proporcionado no se ajusta a la documentación.
500	SERVER_ERROR	Se ha producido un error al procesar la solicitud.	Hay un problema en el servidor que ha provocado un error.
409	FLIGHT_NOT_AVAILABLE	El vuelo solicitado no está disponible.	El vuelo solicitado ya no está disponible.

Aquí puedes explorar las definiciones de punto de conexión de esta API, ir a API Explorer para probar todos los puntos de conexiones de XAP, descargar las especificaciones de OpenAPI y descargar nuestras colecciones de Postman. Hacer pruebas con una de estas opciones o con todas te permitirá comprender qué diferencia hay entre los ejemplos y las definiciones del esquema y los resultados reales.