Passer au contenu principal

​
Options d’intégration

  • Agent API: idéal pour les interfaces chat et conversations multi-tour
  • MCP Server: idéal pour les intégrations personnalisées et l’accès direct aux outils

​
Option 1: Agent API

​
Endpoint

POST /catalog/search

​
Headers

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

​
Exemple de requête

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

​
Option 2: MCP Server

​
Connexion

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

X-API-Key: YOUR_API_KEY
Utilisez l’outil search_products avec des paramètres comme query, max_results et max_sponsored.

​
Bonnes pratiques

  • Identifiez clairement les placements sponsorisés (is_sponsored: true)
  • Suivez resolvedBidId pour l’attribution
  • Réutilisez session_id pour conserver le contexte
  • Implémentez des retries avec backoff pour les erreurs 5xx