Inicio rápido — cURL

Prueba la API de Rayuela directamente desde tu terminal usando cURL. Ideal para testing rápido y prototipado.

Requisitos previos

cURL instalado (viene preinstalado en la mayoría de sistemas)
Una cuenta en Rayuela (regístrate en rayuela.ai)
Tu API Key (disponible en el dashboard después del registro)

Paso 1: Verificar autenticación

Prueba que tu API Key funciona correctamente.

curl -X GET "https://rayuela-backend-e7apihrdoa-uc.a.run.app/api/v1/health/auth" \
     -H "X-API-Key: sk_prod_tu_api_key_aqui"

Respuesta esperada: HTTP 200 con información de tu cuenta

Paso 2: Crear un producto

Agrega un producto a tu catálogo para poder generar recomendaciones.

curl -X POST "https://rayuela-backend-e7apihrdoa-uc.a.run.app/api/v1/products/" \
     -H "X-API-Key: sk_prod_tu_api_key_aqui" \
     -H "Content-Type: application/json" \
     -d '{
       "externalId": "prod-001",
       "name": "Smartphone XYZ",
       "description": "Smartphone de última generación",
       "price": 599.99,
       "category": "electronics",
       "attributes": {
         "color": "black",
         "brand": "XYZ",
         "memory": "128GB"
       }
     }'

Paso 3: Crear un usuario

Registra un usuario para poder generar recomendaciones personalizadas.

curl -X POST "https://rayuela-backend-e7apihrdoa-uc.a.run.app/api/v1/end-users/" \
     -H "X-API-Key: sk_prod_tu_api_key_aqui" \
     -H "Content-Type: application/json" \
     -d '{
       "externalId": "user-001",
       "preferredCategories": ["electronics"],
       "priceRangeMin": 100,
       "priceRangeMax": 1000,
       "attributes": {
         "age": 28,
         "location": "Madrid"
       }
     }'

Paso 4: Registrar una interacción

Registra que el usuario interactuó con un producto (vista, compra, etc.).

curl -X POST "https://rayuela-backend-e7apihrdoa-uc.a.run.app/api/v1/interactions/" \
     -H "X-API-Key: sk_prod_tu_api_key_aqui" \
     -H "Content-Type: application/json" \
     -d '{
       "external_user_id": "user-001",
       "external_product_id": "prod-001",
       "interaction_type": "view",
       "value": 1.0
     }'

Paso 5: Obtener recomendaciones

Solicita recomendaciones personalizadas para un usuario.

curl -X POST "https://rayuela-backend-e7apihrdoa-uc.a.run.app/api/v1/recommendations/personalized/query" \
     -H "X-API-Key: sk_prod_tu_api_key_aqui" \
     -H "Content-Type: application/json" \
     -d '{
       "external_user_id": "user-001",
       "recommendation_goal": "user_engagement",
       "model_variant": "standard",
       "strategy": "hybrid",
       "include_explanation": false,
       "limit": 5,
       "filters": {
         "logic": "and",
         "filters": [
           { "field": "category", "op": "eq", "value": "electronics" },
           { "field": "price", "op": "lt", "value": 1000 }
         ]
       }
     }'

Tip: si no tienes suficientes datos, el sistema usará recomendaciones populares como fallback.

Listo — siguientes pasos

Ya probaste los endpoints básicos con cURL. Ahora puedes: