API-Referenz

Diese Seite bietet detaillierte Informationen zur FelAIProductAdvisor API.

Empfehlungs-API

Empfehlungen abrufen

GET /api/fel-ai-product-advisor/recommendations

Query-Parameter

Parameter	Typ	Beschreibung
productId	string	ID des Produkts, für das Empfehlungen abgerufen werden sollen
limit	integer	Anzahl der zurückzugebenden Empfehlungen (Standard: 5)
algorithm	string	Zu verwendender Algorithmus (collaborative, content-based, hybrid)
minConfidence	float	Minimale Konfidenz-Score (0.0-1.0)

Antwort

{
  "recommendations": [
    {
      "id": "product-id-1",
      "name": "Produktname",
      "price": 19.99,
      "thumbnailUrl": "https://example.com/image.jpg",
      "url": "/detail/product-id-1",
      "confidence": 0.95
    },
    // Weitere Produkte...
  ]
}

Kundenempfehlungen abrufen

GET /api/fel-ai-product-advisor/customer-recommendations

Query-Parameter

Parameter	Typ	Beschreibung
customerId	string	ID des Kunden, für den Empfehlungen abgerufen werden sollen
limit	integer	Anzahl der zurückzugebenden Empfehlungen (Standard: 5)

Antwort

Wie bei "Empfehlungen abrufen".

Analytics-API

Empfehlungsleistung abrufen

GET /api/fel-ai-product-advisor/analytics/performance

Query-Parameter

Parameter	Typ	Beschreibung
startDate	string	Startdatum (JJJJ-MM-TT)
endDate	string	Enddatum (JJJJ-MM-TT)

Antwort

{
  "clickThroughRate": 0.15,
  "conversionRate": 0.05,
  "totalImpressions": 10000,
  "totalClicks": 1500,
  "totalConversions": 500,
  "revenue": 15000
}

Webhook-API

Webhook registrieren

POST /api/fel-ai-product-advisor/webhooks

Request Body

{
  "url": "https://your-server.com/webhook",
  "events": ["recommendation.clicked", "recommendation.converted"],
  "secret": "your-secret-key"
}

Antwort

{
  "id": "webhook-id",
  "url": "https://your-server.com/webhook",
  "events": ["recommendation.clicked", "recommendation.converted"],
  "createdAt": "2023-06-15T10:30:00Z"
}