{"service":"Recommender Service","version":"1.1.0","description":"A/B Testing Recommendation System for Ser+ Platform","experiment":"Recombee vs LightFM","university":"University of Aveiro","features":{"recommendations":"Personalized recommendations with A/B testing","search":"Personalized full-text search","similarItems":"Item-to-item recommendations","eventTracking":"Conversion tracking with recommId attribution","viewPortion":"Track partial content views"},"documentation":{"authentication":"All endpoints (except public) require Bearer token authentication","recommId":"Include recommId from recommendation responses in events for conversion attribution","rateLimit":{"recommendations":"30 requests/minute per user","events":"100 requests/minute per user","general":"120 requests/minute per user","admin":"200 requests/minute per admin"},"caching":{"recommendations":"5 minutes TTL","stats":"2 minutes TTL"}},"endpoints":{"health":{"basic":"GET /health","detailed":"GET /health/detailed","ready":"GET /ready","live":"GET /live"},"monitoring":{"metrics":"GET /metrics","stats":"GET /stats [AUTH REQUIRED]","cacheStats":"GET /cache/stats [AUTH REQUIRED]"},"recommendations":{"recommend":"POST /recommend/:scenario [AUTH REQUIRED]","similar":"POST /recommend/similar/:itemId [AUTH REQUIRED]","postEnrollment":"POST /recommend/post-enrollment/:itemId [AUTH REQUIRED]","users":"POST /recommend/users [AUTH REQUIRED]","search":"POST /search [AUTH REQUIRED]","logEvent":"POST /log-event [AUTH REQUIRED]","logViewPortion":"POST /log-view-portion [AUTH REQUIRED]","myHistory":"GET /recommendations/me [AUTH REQUIRED]","myEvents":"GET /events/me [AUTH REQUIRED]"},"preferences":{"typologies":"GET /preferences/typologies [AUTH REQUIRED]"},"admin":{"userHistory":"GET /admin/recommendations/user/:userId [ADMIN ONLY]","userEvents":"GET /admin/events/user/:userId [ADMIN ONLY]","syncRun":"POST /admin/sync/run [ADMIN ONLY]","clearCache":"POST /admin/cache/clear [ADMIN ONLY]","metricsAggregated":"GET /admin/metrics/aggregated [ADMIN ONLY]","metricsSummary":"GET /admin/metrics/summary [ADMIN ONLY]","metricsComparison":"GET /admin/metrics/comparison [ADMIN ONLY]","metricsHistory":"GET /admin/metrics/history/:metricName [ADMIN ONLY]","metricsAggregate":"POST /admin/metrics/aggregate [ADMIN ONLY]","metricsJobStatus":"GET /admin/metrics/job-status [ADMIN ONLY]","metricsCleanup":"POST /admin/metrics/cleanup [ADMIN ONLY]"}},"scenarios":{"userToItem":["home_feed","onboarding","profile_similar","my_initiatives","similar_users"],"itemToItem":["profile_similar","post_enrollment"],"search":["search_enhance"]},"eventTypes":["view","click","enroll","complete","save","share","rate","unlike","connect"]}