Primeros pasos con las API

Utiliza los datos de Expedia con autenticación y autorización

Para utilizar las API de la plataforma de viajes de Expedia Group, debes crear uno o más clientes API, que son como cuentas de usuario protegidas con contraseña. Básicamente, un cliente API establece que el software que realiza una solicitud de API te pertenece (autenticación) y te permite limitar los tipos de solicitudes de API que puede realizar cada cliente (autorización).

Haz pruebas con nuestra función Sandbox

Fraud Prevention Service ha habilitado la función Sandbox, que te permite probar los resultados de la API de manera que no se reflejen en la aplicación de producción. Prueba las API de Fraud Prevention Service con credenciales específicas para Sandbox en nuestra API Explorer, Postman u otras herramientas, y pon a prueba las configuraciones antes de publicarlas.

Para obtener más instrucciones sobre cómo probar las API en el entorno Sandbox, lee Sandbox de Fraud Prevention.

Cómo crear un cliente API

Tanto si quieres empezar en Sandbox o ir directamente al entorno de producción, puedes crear y gestionar tus clientes API en Expedia Group Console. Para poder crear un cliente API, antes debes añadir productos a tu cuenta.

Pasos:

En la consola, haz clic en el enlace Crear cliente API en la esquina inferior izquierda.
En la página Create new API client, asigna al cliente un nombre y una descripción que os permitan recordar qué productos incluye tanto a ti como a otras personas de tu organización.
En la lista de productos disponibles, marca las casillas junto a los ámbitos (tipos de solicitud de API) que quieras incluir. Al marcar la casilla en el nivel superior, se seleccionarán todos los elementos secundarios.
Haz clic en Obtener credenciales.
Copia las credenciales y guárdalas en un lugar seguro.

Nota: Las credenciales de la API solo se muestran al crear el cliente, por lo que deberás copiarlas y guardarlas antes de continuar. No podrás volver a verlas.

Puedes crear tantos clientes API como necesites. Se pueden otorgar permisos específicos a cada cliente, lo que te permite limitar qué puede hacer cada uno de los servicios de software en la plataforma de viajes de Expedia Group.

Productos y ámbitos

Todos los clientes API funcionan en una única cuenta de colaborador. Cuando añadas productos a la cuenta, podrás incluirlos en un cliente API. Asimismo, tienes la opción de crear un único cliente API y otorgarle acceso a uno o más productos.

Cada producto incluye un conjunto de ámbitos que conceden acceso a ciertos tipos de solicitudes. Los ámbitos que asignes controlarán lo que ese cliente está autorizado a hacer. Si tienes varios servicios de software que realizan solicitudes de API, te recomendamos que crees un cliente API independiente para cada servicio y selecciones solo los ámbitos que necesitará cada cliente.

Credenciales del cliente

Cada cliente API recibe un ID y un secreto para la autenticación, que funcionan de forma similar a un nombre de usuario y una contraseña. Las credenciales solo se muestran al crear el cliente, por lo que deberás copiarlas y guardarlas antes de continuar.

Es muy importante que almacenes las credenciales del cliente API. No guardes el ID del cliente ni el secreto en zonas de acceso público como GitHub, código del cliente, etc.

Explorar

Si solo quieres probar las API en API Explorer, ya lo tienes todo listo para empezar. Puedes introducir la clave del cliente API (client_id) y el secreto directamente en la UI de API Explorer marcando Show authentication section.

Para saber cómo incrustar un cliente API en tu software, consulta Autenticación y autorización de API.