Introducción a Rapid

Empezar a usar Rapid es muy sencillo. Solo tienes que conseguir una clave para la API y un secreto compartido, configurar la autentificación de Rapid y comenzar las pruebas.

1. Colabora con nosotros

Para integrarte en Rapid, tienes que unirte como colaborador si aún no lo has hecho.

2. Revisa las condiciones del lanzamiento que sean relevantes para tu sitio web

Revisa los requisitos de lanzamiento para decidir cuáles necesitarán desarrollo de una interfaz de usuario front-end y ten este dato en cuenta a la hora de planificar el proyecto.

• B2B independiente
• B2C independiente

3. Prepara el entorno

Consulta estos recursos para preparar el entorno para el uso de Rapid.

• Cómo funciona
• Gestión de solicitudes de reserva
• Creación de políticas de cancelación

4. Obtén las credenciales y configura la autenticación de Rapid

Una vez que pases a colaborar con nosotros y se haya aprobado la integración con Rapid, tendrás que obtener tu clave para la API. Para ello, inicia sesión en el portal de EPS y haz clic en Connectivity en la barra de menús de la izquierda. Después, selecciona la clave para la API entre las opciones. Se te mostrarán los datos actuales de la clave para la API.

La clave para la API es una de las dos credenciales clave necesarias para el sistema de verificación por firma de Rapid. También necesitarás tu secreto compartido, al que puedes acceder desde el portal de EPS, en la página "Claves para la API". La clave para la API estará en un modo de desarrollo restringido hasta que se haya aprobado tu lanzamiento a un entorno de producción tras la revisión de tu sitio web.

Si quieres presentar una solicitud a nuestro servicio de API, ya sea en pruebas o en producción, debes usar el encabezado HTTP de autorización para transmitir la clave para la API y un hash de firma SHA-512 con cada solicitud. El hash SHA-512 está conformado por tu secreto compartido, la clave para la API y un sello temporal UNIX. Los encabezados de autorización de Rapid siempre siguen este formato:

Authorization: EAN APIKey=yourAPIKey,Signature=sha512Hash,timestamp=yourUNIXTimestamp

Consulta todos los detalles en nuestra página de verificación por firma. También puedes utilizar nuestra herramienta de generación de firmas para crear el valor del hash SHA-512 con el que se evaluará tu integración.

5. Comienza a probar las solicitudes

Cuando hayas recibido tus credenciales y configurado la autenticación de Rapid, podrás comenzar a realizar solicitudes para valorar nuestro punto de conexión de prueba a través de la URL https://test.ean.com/. Las solicitudes de reservas puestas a prueba en https://test.ean.com/ no generarán reservas reales de alojamiento ni cargos en tarjetas. Puedes elegir entre nuestros encabezados de prueba documentados para la API de reservas y controlar así qué tipo de respuesta quieres ver. Si omites el encabezado de prueba de las solicitudes relacionadas con la reserva, el servidor de prueba añadirá uno automáticamente.

IMPORTANTE: Se aplican límites de tarifas para garantizar que se ofrece un servicio estable y viable a todos los colaboradores. El sistema controla el tráfico anómalo de la API y tomará medidas para protegerse automáticamente. Antes de aplicar cambios al comportamiento de llamar a la API o de realizar pruebas de rendimiento con acceso a la API, asegúrate de que revisas tus planes con tu consultor de Rapid.

Cómo indicar tu versión de la API

Utiliza el valor servers.url en OpenAPI Spec para construir la URL. test.ean.com se usa para validar la integración, mientras que api.ean.com es el punto de conexión de producción. Conserva el protocolo y la ruta cuando cambies de punto de conexión.

https://test.ean.com/v3/itineraries?… https://api.ean.com/v3/properties/22135/payment-options?token=U1dFC0JHTW

El valor servers.url se encuentra en la parte superior de nuestros archivos de la OpenAPI Spec descargables y siempre se corresponderá con el número de versión para el servicio de API en cuestión.

Ejemplo: OpenAPI Spec

openapi: 3.0.1
info:
  title: Rapid
  description: EPS Rapid V3
  version: v3
servers:
  - url: https://test.ean.com/v3

6. Solicita una revisión del sitio web

Una vez que consideres que la integración está lista y hayas confirmado que cumple los requisitos de lanzamiento aplicables, solicita al responsable de desarrollo empresarial que revise el sitio web. Cuando recibas la aprobación para iniciar la migración, el responsable de desarrollo empresarial habilitará la clave para la API, que podrás emplear en la producción. Solo tienes que cambiar los puntos de conexión de la solicitud de https://test.ean.com/ a https://api.ean.com y seguir haciendo solicitudes. No es necesario cambiar ningún otro código.