Cómo configurar Aura AI API en tu plataforma de bienestar

El primer paso para utilizar Aura AI API consiste en iniciar sesión en el portal oficial de Aura en useaura.it utilizando tus credenciales corporativas habituales. Una vez dentro del sistema, verás la pantalla principal del panel de control o dashboard. En la barra de navegación lateral izquierda, localiza y haz clic en la sección denominada 'API & Integraciones'. La interfaz mostrará inmediatamente un botón destacado con el texto 'Crear nueva aplicación'. Al pulsarlo, aparecerá un formulario emergente donde deberás introducir el nombre de tu proyecto y seleccionar el entorno de pruebas, conocido como entorno de sandbox, el cual te permite realizar llamadas de prueba sin afectar datos reales de producción durante tu fase de desarrollo y validación inicial.

Tras completar el formulario de registro de la aplicación en el panel, la pantalla actualizará su contenido para mostrarte el resumen de tu proyecto recién creado. En la parte central de este apartado visualizarás el bloque correspondiente a las credenciales de autenticación. Verás un campo que muestra el identificador único del cliente y, justo debajo, la clave secreta principal de la API. La interfaz incluye un icono con forma de portapapeles al lado de cada cadena de texto; al hacer clic en él, copias el valor directamente al portapapeles de tu dispositivo. Es fundamental que guardes estos datos en un gestor de secretos o en variables de entorno seguras dentro de tu infraestructura técnica, ya que esta clave secreta no volverá a mostrarse completa en pantalla por motivos de seguridad una vez que cierres o recargues la pestaña actual.

El siguiente paso requiere definir qué tipos de datos de bienestar deseas consultar o sincronizar mediante las peticiones HTTP. En el mismo panel de control de Aura, desplázate hacia abajo hasta la pestaña de 'Configuración de Endpoints'. La pantalla presenta una lista con interruptores deslizantes para habilitar servicios específicos, tales como meditaciones guiadas, seguimiento del estado de ánimo, recomendaciones de sonidos relajantes o métricas de actividad física resumidas. Debes activar únicamente los interruptores correspondientes a las funciones que tu plataforma va a consumir. Al activar cada opción, la interfaz genera automáticamente una URL base con la ruta específica del endpoint, facilitando la copia de la ruta exacta para que tus ingenieros de software puedan integrarla directamente en las solicitudes de red de tu aplicación.

Para verificar que la comunicación con Aura AI API es correcta antes de escribir código en tu entorno de desarrollo, utiliza el simulador interactivo integrado en el panel. En la parte superior de la página de tu proyecto, haz clic en la pestaña 'API Explorer'. La pantalla se divide en dos columnas: a la izquierda verás un editor de código con un cuerpo de petición JSON predeterminado para solicitar una recomendación de relajación de cinco minutos, y a la derecha verás un espacio en blanco reservado para la respuesta del servidor. Haz clic en el botón azul 'Enviar Petición'. En menos de un segundo, la columna derecha se llenará con una respuesta en formato JSON que contiene el título del contenido, la duración exacta y la URL de reproducción multimedia generada específicamente para esa simulación.

Una vez que tu integración se encuentra activa y procesando solicitudes reales de usuarios, el seguimiento del rendimiento se realiza desde la sección 'Analíticas y Uso' en el menú principal. La pantalla principal de este apartado muestra gráficos de líneas que actualizan el volumen de peticiones por minuto, el tiempo de latencia promedio de respuesta del servidor y la tasa de aciertos o errores HTTP. En la esquina superior derecha de esta misma vista, un contador visual en forma de barra de progreso indica el porcentaje de llamadas consumidas respecto al límite mensual contratado en tu plan. Si el volumen de uso se aproxima al límite establecido, la interfaz muestra una advertencia visual amarilla que te invita a revisar tu suscripción o configurar alertas automáticas para evitar interrupciones en el servicio.