runfood-cloudbeds-api

Integración con CloudBeds usando NodeJS

Requisitos

Solicita el acceso por API:

Desde tu cuenta CloudBeds, entra a [⚙️Manage] -> [🔌Apps e Integraciones] -> [Credenciales de API] Expon el caso y obtén la aprobación de parte de CloudBeds.

Una vez aprobado, regresa a la opción anterior, luego aplasta en AGREGAR CREDENCIAL. Sigue los pasos y guarda los parámetros:

• secret_id
• client_id
• redirectUrl

Inicia sesión desde CloudBeds

Realiza los pasos Test Flow -> 1 - 3 (https://integrations.cloudbeds.com/hc/en-us/articles/360006450433-OAuth-2-0). Cuando el usuario se ha loggeado y ha sido redireccionado a tu pagina (que pusiste en el parametro redirect_uri) obtendrás el parametro code. Ahora debes llamar a requestAccessToken() de este paquete para obtener el primer access_token y refresh_token. A partir de este punto ya inicializar y utilizar el paquete.

Manejo del paquete

Este proceso utiliza definiciones de tipos (d.ts). Asi que puedes consultar los parámetros de cada función.

El manejo del paquete es como sigue:

1. Inicializa el paquete Primero debes inicializar el paquete, ejecuta init(). Si esta función es llamada después de que el parquete haya sido inicializado, no tendrá ningún efecto y no lanzará ningún error.

2. Agrega un callback para el evento onTokenChange (Este evento se disparará cada vez que el access_token y refresh_token cambien. Guarda ambos valores en un almacenamiento persistente. La siguiente vez que inicies tu aplicación e inicialices el paquete deberás utilizar estos valores). Vease el flujo de OAuth 2.0 (https://integrations.cloudbeds.com/hc/en-us/articles/360006450433-OAuth-2-0)

3. Obten las reservaciones, utilizando la función getReservations(query:object).

4. Obten los valores especificos de una reservacion, utilizando getReservation(reservationID:string)