ИИ-агентам и разработчикам

Перенесите каталог за один вечер

Товары магазина — из 1С, кассы или своей базы — по API, с проверкой без записи, понятными ошибками и откатом в один клик. Документацию агент прочтёт сам: /llms.txt и OpenAPI.

Получите ключ

Кабинет магазина → «Подключить агента». Ключ и готовый текст для агента показываем один раз. Песочный ключ всё проверяет, но ничего не записывает.

Authorization: Bearer ve_live_…

Узнайте, чей каталог

Ключ привязан к магазину: агент видит его точки продаж и сколько товаров уже загружено.

curl -H "Authorization: Bearer $KEY" https://vremyaeconomit.ru/api/v1/me
curl -H "Authorization: Bearer $KEY" https://vremyaeconomit.ru/api/v1/stores

Проверьте пакет без записи

До 1000 товаров за раз. Артикул (external_id) — ключ: повтор того же пакета ничего не дублирует. Поля, которых у товара нет в пакете, остаются прежними: для ежедневных цен и остатков хватит external_id, name, price и quantity.

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  https://vremyaeconomit.ru/api/v1/products/batch -d '{
  "dry_run": true,
  "title": "Перенос из 1С",
  "products": [
    {"external_id": "00-001", "name": "Саморез по дереву 3,5х25, 100 шт", "price": "189,90",
     "unit": "уп", "quantity": 12, "category": "Крепёж", "barcode": "4607001234562"}
  ]}'

Исправьте ошибки и опубликуйте

Ошибки — по каждому товару: поле, код и подсказка «что не так». Исправьте и пришлите только исправленные, затем тот же пакет без dry_run.

{"index": 1, "external_id": "00-002", "action": "error",
 "errors": [{"field": "price", "code": "invalid",
             "message": "«от 100» — не похоже на цену: нужно число, например 1190,50"}]}

Фото — ссылками или файлами

До 10 фото на товар, JPEG, PNG или WebP. Ссылки в поле photos скачаем сами в фоне (итог — в GET /api/v1/products), файлы — так, как ниже. Метаданные (EXIF, GPS) удаляем, храним только WebP.

curl -X POST -H "Authorization: Bearer $KEY" \
  -F files=@00-001.jpg -F files=@00-001_2.jpg \
  "https://vremyaeconomit.ru/api/v1/products/photos?external_id=00-001"

MCP

Или подключите нас как MCP-сервер

Агент сам найдёт инструменты: поиск в магазинах рядом и выбор места — без ключа; каталог продавца, пакеты и откат — с ключом.

{
  "mcpServers": {
    "vremyaeconomit": {
      "type": "http",
      "url": "https://vremyaeconomit.ru/api/mcp",
      "headers": { "Authorization": "Bearer ve_live_…" }
    }
  }
}

Синхронизация

mode: "sync" — товары, которых нет в пакете, скрываем с витрины (не удаляем).

Предохранители

Цена изменилась в 3 и более раза или синхронизация скрывает больше 20 % каталога — пакет ждёт подтверждения владельца (status: pending_approval). Повторять не нужно.

Запрещённое

Алкоголь, табак и никотин, лекарства, оружие, товары 18+ записываем в каталог, но покупатели их не видят (moderation: "rejected"); подозрительное показываем после проверки модератором ("pending"). Причина — moderation_reason.

Свежие цены

Предложение видно, если цену и наличие подтверждали за 30 дней — повтор пакета подтверждает. Если модератор, уточнив в магазине, подтвердил, что цена или наличие не совпали, предложение скрыто (mismatch_id), пока не изменится то, что не совпало; остаток сам по себе не возвращает.

История и откат

Каждый пакет — в истории кабинета и в GET /api/v1/change-sets; откат в один клик возвращает товары к версии до пакета.

Частота

До 300 чтений и 30 пакетов в минуту на ключ; сверх — 429 и заголовок Retry-After.

Условия

Пользуясь API, вы и ваш агент принимаете пользовательское соглашение (vremyaeconomit.ru/legal/terms, раздел 9), а продавцы — ещё и оферту для продавцов (/legal/offer).

Магазина ещё нет в сервисе? Как подключить магазин →

Где ищем?