Перейти к содержанию

API

Разработчикам

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

Первый вызов за три минуты

  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, вебхуки, паспорт продукта.

Руководства скоро появятся.