Aller au contenu

API

Développeurs

L’API publique d’Itemoo pour l’ERP, l’entrepôt et la production, et les données produit pour agents et scanners. La documentation naît du code de l’API.

Le premier appel en trois minutes

  1. Dans le tableau de bord Itemoo, ouvrez Intégrations → Clés API et créez une clé avec les droits nécessaires. Vous ne verrez la clé qu’une fois.

  2. Vérifiez la connexion : GET /v1/ping avec l’en-tête Authorization: Bearer itm_…

  3. Envoyez les stocks ou récupérez les commandes — chaque point d’accès ci-dessous a un exemple. Les notifications de commande se configurent au même endroit.

Créer une clé dans le tableau de bord →

cURL

curl 'https://itemoo.eu/v1/ping' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

Serveurs MCP pour assistants IA

Le Model Context Protocol permet aux assistants IA (Claude, ChatGPT et autres) d’utiliser Itemoo sans intégration sur mesure : l’assistant découvre seul les outils et leurs paramètres.

MCP global — produits et achats

Recherche de produits, marques, entreprises, vendeurs et articles, données produit avec la source de chaque information, rappels, documents et panier avec lien vers la caisse. Sans connexion. La recherche couvre les marques qui ont accepté d’y figurer ; l’acheteur paie toujours dans la boutique de la marque.

Adresse du serveur

https://itemoo.eu/mcp

Outils

  • search — Search products, brands, companies, sellers and articles
  • brand_get — Brand profile
  • product_lookup — Product data with provenance
  • recall_status — Recall and safety notice status
  • documents_list — Product documents
  • sellers_for_product — Where to buy
  • cart_create — Prepare a cart in a brand shop

MCP de la marque — les données de votre marque

Catalogue, lots, scans, lacunes de conformité, ventes et stock en chiffres, sans données personnelles des clients. Avec l’accord distinct du propriétaire de la marque, l’assistant crée aussi des brouillons de pages produit, de publications, d’articles, de campagnes et du site de la marque — une personne les publie toujours dans le panneau. Chaque connexion appartient à une personne de l’équipe et à une marque.

Votre marque : adresse dans le panneau

https://itemoo.eu/mcp/b/{brand}

  1. Le propriétaire de la marque l’active dans le panneau, Intégrations → Assistants IA (MCP), et choisit les rôles autorisés à se connecter.

  2. Dans votre assistant, ajoutez un connecteur personnalisé avec l’adresse du serveur de la marque indiquée dans le panneau.

  3. Connectez-vous à Itemoo et approuvez l’accès. L’assistant ne voit que ce que votre rôle permet ; vous révoquez la connexion dans le panneau.

Outils

  • products_list — Products of the brand
  • products_get — Product details
  • batches_list — Batches (LOT)
  • codes_stats — QR code and unit statistics
  • scans_analytics — Scan analytics
  • plan_usage — Plan and usage
  • catalog_gaps — Catalogue gaps
  • translations_status — Translation status
  • orders_summary — Orders summary
  • customers_summary — Customers summary
  • stock_overview — Stock overview
  • promotions_list — Promotions
  • marketplace_status — Marketplace channels
  • team_overview — Team overview
  • billing_summary — Billing summary
  • product_page_get — Product page draft for editing
  • product_draft_create — Create product drafts
  • product_page_draft_patch — Edit a product page draft
  • site_draft_get — Brand website draft
  • site_draft_patch — Edit the brand website draft
  • publications_list — Social media posts
  • publication_get — One post
  • publication_draft_upsert — Create or edit a post draft
  • articles_list — Knowledge articles
  • article_get — One article
  • article_draft_upsert — Create or edit an article draft
  • campaigns_list — Push and newsletter campaigns
  • campaign_get — One campaign
  • campaign_draft_upsert — Create or edit a campaign draft
  • draft_discard — Discard your own draft

cURL

curl -X POST 'https://itemoo.eu/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"resin"}}}'

Guides

Pas à pas : connecter l’ERP, les webhooks, le passeport produit.

Les guides arrivent bientôt.