Золотенков

Версия 1.0.0 · OpenAPI 3.1

Справочник публичного API

Публичное REST API открывает учет Золотенков МРП другим системам: 1С, маркетплейсам, вашим сервисам и ИИ-агентам. У каждой ручки здесь своя страница с параметрами, примером запроса и примерами ответов.

С чего начать

  1. 1

    Выпустите ключ

    Раздел «Настройки → API-ключи» в Золотенков МРП. Значение показывается один раз — сохраните его в менеджере секретов на своем сервере.

  2. 2

    Выдайте только нужные права

    Право — это разрешение на одно действие. Интеграция получает ровно те, без которых ее сценарий не работает.

  3. 3

    Сделайте первый запрос

    Список товаров — самый безопасный первый вызов: он ничего не меняет и сразу показывает, что ключ принят.

Первый запрос
curl --request GET \
  --url 'https://mrp.zolotenkov.ru/api/external/v1/products?limit=5' \
  --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \
  --header 'Accept: application/json'

Разделы

Всего 56 ручек на 42 адресах.

План

План: прогноз остатков, дефициты и рекомендации к пополнению.

Отчеты

Отчеты: сводные срезы за период — продажи и выпуск, сложенные по товару и периоду.

События

События: подписки на уведомления и состав полезной нагрузки каждого события (раздел `webhooks` этого документа).

Служебные

Служебное: телеметрия безопасности.

Подключение ИИ-агента

Тот же учет доступен агенту напрямую, по протоколу MCP: агент сам выбирает нужное действие из этого справочника. Настройка занимает одну команду.

Как подключить агента →