Перейти до змісту

API

Розробникам

Публічний API Itemoo для ERP, складу й виробництва та дані про продукти для агентів і сканерів. Документація генерується з робочого коду API.

v1 Випуск 1.0.0

API паспорта (EN 18222:2026)

Життєвий цикл і пошук паспорта за EN 18222:2026: читання (зокрема на дату й за ідентифікатором продукту), створення та зміна в моделі EN 18223:2026. Читання без ключа, запис — із ключем бренду.

Довідник →Журнал змінOpenAPI

Перший виклик за три хвилини

  1. У панелі Itemoo відкрийте Інтеграції → API-ключі та створіть ключ із потрібними областями доступу. Ключ буде показано лише один раз.

  2. Перевірте з’єднання: GET /v1/ping із заголовком Authorization: Bearer itm_…

  3. Надсилайте залишки або отримуйте замовлення — для кожного ендпоінта нижче є приклад. Сповіщення про замовлення налаштовуються в тому самому розділі панелі.

Створити ключ у панелі →

cURL

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

Сервери MCP для ШІ-асистентів

Model Context Protocol дає змогу ШІ-асистентам (Claude, ChatGPT та іншим) користуватися Itemoo без окремої інтеграції: асистент сам виявляє інструменти та їхні параметри.

Глобальний MCP — товари й покупки

Пошук товарів, брендів, компаній, продавців і статей, дані товару з джерелом кожного факту, відкликання, документи та кошик із посиланням на оформлення. Без входу. Пошук охоплює бренди, які погодилися бути в ньому; оплата завжди в магазині бренду.

Адреса сервера

https://itemoo.eu/mcp

Інструменти

  • 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 бренду — дані вашого бренду

Каталог, партії, сканування, прогалини у відповідності, продажі й склад у цифрах — без персональних даних клієнтів. З окремої згоди власника бренду асистент також створює чернетки сторінок товарів, публікацій, статей, кампаній і сайту бренду — публікує їх завжди людина в панелі. Кожне з’єднання належить одній людині з команди й одному бренду.

Ваш бренд: адреса в панелі

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

  1. Власник бренду вмикає це в панелі: Інтеграції → ШІ-асистенти (MCP) — і вибирає ролі, яким дозволено підключатися.

  2. В асистенті додайте власний конектор з адресою сервера бренду, показаною в панелі.

  3. Увійдіть до Itemoo й підтвердьте доступ. Асистент бачить лише те, що дозволяє ваша роль; з’єднання можна відкликати в панелі.

Інструменти

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

Посібники

Крок за кроком: підключення ERP, вебхуки, паспорт продукту.

Посібники незабаром з’являться.