Zum Hauptinhalt springen

​
Integrationsoptionen

  • Agent API: fur Chat-Interfaces und Multi-Turn-Konversationen
  • MCP Server: fur individuelle Integrationen und direkten Tool-Zugriff

​
Option 1: Agent API

​
Endpoint

POST /catalog/search

X-API-Key: YOUR_API_KEY
Content-Type: application/json

​
Request-Beispiel

{
  "query": "I need running shoes under $150",
  "session_id": "user-session-123",
  "max_results": 10,
  "max_sponsored": 3,
  "streaming": false
}
Wichtige Felder: query, session_id, max_results, max_sponsored, streaming.

​
Option 2: MCP Server

​
Verbindung

URL: https://your-mcp-server.example.com/mcp
Transport: Streamable HTTP

X-API-Key: YOUR_API_KEY
Nutzen Sie das Tool search_products mit Parametern wie query, max_results und max_sponsored.

​
Best Practices

  • Kennzeichnen Sie Sponsored-Produkte klar (is_sponsored: true)
  • Tracken Sie resolvedBidId fur Attribution
  • Nutzen Sie dieselbe session_id fur Follow-up-Fragen
  • Implementieren Sie Retry mit Backoff fur 5xx-Fehler