API de resumen de itinerario

Guía y ejemplos para acceder a la API de resumen de itinerario

La API de resumen de itinerario permite a un colaborador consultar todos los itinerarios que se han reservado en una única cuenta de usuario de Expedia.

Punto de conexión

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

Encabezados obligatorios

Clave:	Clave de API de Expedia
Autorización:	Cadena de autorización de API de Expedia
User-Id:	nombredeusuario@dominio.com
Aceptar:	application/vnd.exp-booking.v3+json
Partner-Transaction-Id:	Cadena de TransactionID de colaborador

Encabezados opcionales

Contraseña:

[Contraseña de la cuenta de Expedia] Inclúyelo si la reserva se hace con una cuenta de usuario de Expedia. Déjalo en blanco si se reserva como invitado.

Pasos siguientes

El usuario puede enlazar con el sitio web de Expedia para ver el itinerario.
El usuario puede utilizar la consulta API opcional para acceder a los datos del itinerario.

Ejemplo de consulta a la API de resumen de itinerario

URL de solicitud

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

Respuesta

{
	"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 advertencia

Códigos de advertencia más frecuentes

Código de advertencia	Respuesta de advertencia	Causa
MAX_LIMIT_EXCEEDED	Se ha superado el número máximo de itinerarios que se pueden recuperar. Límite permitido: 100.	Se ha superado el número máximo de itinerarios que el sistema puede recuperar. Filtre los resultados.
INVALID_TRIP_LIMIT	El límite no es válido. Los valores permitidos son números en el rango [1 - 100].	El valor del parámetro URL de "Limit" no era de un tipo válido. Debe ser un número válido en el rango mencionado. Los resultados se recopilarán en función del límite del sistema.
PARTIAL_RESULTS_DISPLAYED	Se muestran 100 itinerarios de 216.	El criterio de búsqueda estaba dando más resultados de los esperados. El mensaje informará al usuario si hay algún resultado que no se muestra en la respuesta.

Códigos de error

Códigos de error frecuentes

Código de estado HTTP	Código de error	Respuesta de error	Causa
400	INVALID_TRIP_START_DATE	La fecha de inicio tiene un formato no válido. El formato válido es "AAAA-MM-DD".	La fecha de inicio que se ha introducido no tenía el formato definido.
400	INVALID_TRIP_END_DATE	La fecha de fin tiene un formato no válido. El formato válido es "AAAA-MM-DD".	La fecha de fin que se ha introducido no tenía el formato definido.
400	START_DATE_LATER_THAN_END_DATE	La fecha de inicio debe tener lugar antes de la fecha de fin.	La fecha de inicio debe ser anterior a la fecha de fin.
400	INVALID_TRIP_STATUS	El estado del viaje no es válido. El estado debe ser: [BOOKED/ CANCELED/ PENDING/ SAVED]	Utiliza un estado de viaje válido de entre los valores mencionados.

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.