Przejdź do treści

API

Dla deweloperów

Publiczne API Itemoo dla ERP, magazynu i produkcji oraz dane produktu dla agentów i skanerów. Dokumentacja powstaje z kodu, który obsługuje żądania.

API dla ERPPubliczne dane produktuAPI paszportu (EN 18222:2026)

Pierwsze wywołanie w trzy minuty

  1. W panelu Itemoo otwórz Integracje → Klucze API i utwórz klucz z potrzebnymi zakresami. Klucz zobaczysz tylko raz.

  2. Sprawdź połączenie: GET /v1/ping z nagłówkiem Authorization: Bearer itm_…

  3. Wyślij stany albo pobierz zamówienia — przykłady przy każdej trasie poniżej. Powiadomienia o zamówieniach ustawisz w tym samym miejscu panelu.

Utwórz klucz w panelu →

cURL

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

Serwery MCP dla asystentów AI

Model Context Protocol pozwala asystentom AI (Claude, ChatGPT i innym) korzystać z Itemoo bez pisania integracji: asystent sam odkrywa narzędzia i ich parametry.

Globalny MCP — produkty i zakupy

Wyszukiwanie produktów, marek, firm, sprzedawców i artykułów, dane produktu z pochodzeniem faktów, wycofania, dokumenty i koszyk z linkiem do kasy. Bez logowania. W wyszukiwarce są marki, które same na to pozwoliły; płaci zawsze człowiek w sklepie marki.

Adres serwera

https://itemoo.eu/mcp

Narzędzia

  • 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 marki — dane Twojej marki

Katalog, partie, skany, braki zgodności, sprzedaż i magazyn w liczbach, bez danych osobowych klientów. Za osobną zgodą właściciela marki asystent zakłada też szkice stron produktów, postów, artykułów, kampanii i strony marki — publikuje je zawsze człowiek w panelu. Każde połączenie należy do konkretnej osoby z zespołu i jednej marki.

Twoja marka: adres w panelu

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

  1. Właściciel marki włącza w panelu Integracje → Asystenci AI (MCP) i wybiera role, które mogą się łączyć.

  2. W asystencie dodaj własny konektor z adresem serwera marki podanym w panelu.

  3. Zaloguj się do Itemoo i zatwierdź dostęp. Asystent widzi tylko to, na co pozwala Twoja rola; połączenie odwołasz w panelu.

Narzędzia

  • 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"}}}'

Przewodniki

Krok po kroku: podłączenie ERP, webhooki, paszport produktu.

Przewodniki pojawią się tu wkrótce.