Inicio rápido — Node.js

Integra Rayuela en tu aplicación Node.js y obtén tu primera recomendación en menos de 5 minutos.

Requisitos previos

Node.js 14 o superior
npm o yarn
Una cuenta en Rayuela (regístrate en rayuela.ai)
Tu API Key (disponible en el dashboard después del registro)

Paso 1: Instalación

Instala las dependencias necesarias para interactuar con la API de Rayuela.

# Con npm
npm install rayuela-sdk
# Con yarn
yarn add rayuela-sdk

Paso 2: Configuración inicial

Crea un cliente Node.js para interactuar con la API de Rayuela.

import { RayuelaClient } from 'rayuela-sdk';
// Inicializar cliente
const client = new RayuelaClient({
  apiKey: 'sk_prod_tu_api_key_aqui'
});
// Verificar conexión
async function testConnection() {
  try {
    const metrics = await client.getMetrics();
    return true;
  } catch (error) {
    console.error('Error de conexión:', error.message);
    return false;
  }
}

Paso 3: Verificar conexión

Prueba que tu API Key funciona correctamente.

// Probar conexión
async function main() {
  const isConnected = await testConnection();
  
  if (isConnected) {
    console.log('OK: conexión exitosa');
  } else {
    console.log('Error: verifica tu API Key.');
  }
}

main();

Paso 4: Obtener recomendaciones

Solicita recomendaciones personalizadas para un usuario.

// Obtener recomendaciones personalizadas
async function getRecommendations(userId, options = {}) {
  try {
    const response = await client.recommend(userId, {
      limit: options.limit || 5,
      strategy: options.strategy || 'hybrid',
      recommendationGoal: 'user_engagement',
      explain: false,
      filters: options.filters || {
        logic: 'and',
        filters: []
      }
    });
    return response;
  } catch (error) {
    console.error('Error obteniendo recomendaciones:', error.message);
    throw error;
  }
}
// Ejemplo de uso
const recommendations = await getRecommendations('user_123', {
  limit: 5,
  filters: {
    logic: 'and',
    filters: [{ field: 'category', op: 'eq', value: 'electronics' }]
  }
});
console.log('Recomendaciones:', recommendations.items);

Listo — siguientes pasos

Ya tienes configurado el cliente Node.js básico. Ahora puedes: