API

Программный доступ к данным кабинета: товары с планками, дилеры, эпизоды нарушений и сырые наблюдения цен - в формате JSON, постранично. Запись - только матрица РРЦ. Отдельно - вебхук: после каждого ночного среза радар сам отправит список новых эпизодов на ваш адрес. Ключи создаются в настройках фабрики администратором.

Ключи

Ключ выглядит как rrc_ и 40 шестнадцатеричных символов, показывается один раз при создании и хранится в кабинете только хешем. Ключей может быть несколько - по одному на интеграцию, чтобы отзывать их независимо. Отозванный ключ перестает работать сразу. В таблице ключей видно, когда ключ вызывался последний раз.

Как вызывать

Адрес https://app.rrc-radar.ru/api/v1/..., ключ в заголовке:

curl -H "Authorization: Bearer rrc_ваш_ключ" "https://app.rrc-radar.ru/api/v1/violations?status=live&per=100&page=1"

Ответ - JSON с полями page, per, total и items. На странице до 500 записей (per), номер страницы - page. Без ключа или с отозванным - ответ 401, чужие или несуществующие данные - 404, неверное тело - 422.

Ресурсы

• GET /api/v1/products - товары: id, название, модификация, размер, артикул, модель (style), планка и дата ее действия, число витрин, живых эпизодов.
• GET /api/v1/dealers - дилеры со статусом авторизации, почтой и списком витрин.
• GET /api/v1/violations?status=live&from=2026-09-01&to=2026-09-30 - эпизоды; status как вкладки на экране (live, open, notified, disputed, ignored, resolved, all), from и to - по дате открытия. В каждом эпизоде - товар, витрина, дилер, тип цены, планки, минимальная цена, глубина, даты и ссылка в кабинет.
• GET /api/v1/observations?from=&to=&product= - наблюдения цен по дням (по умолчанию за 7 дней): витрина, адрес, тип цены, цена, наличие, статус сбора.
• POST /api/v1/rrc - импорт матрицы: тело JSON-массив объектов {"name": "Модель", "size": "80x200", "rrc": 12990, "modification": "", "sku": ""}. Логика та же, что у экрана импорта: существующим товарам обновляется планка с историей, новые создаются. Ответ - сколько создано, обновлено, без изменений и какие строки пропущены.

Вебхук

Адрес задается в настройках фабрики. После ночного среза, если открылись новые эпизоды, радар отправит POST с JSON: название фабрики, время и массив событий (эпизод, товар, витрина, планка, цена, глубина, ссылка). Заголовок X-Radar-Signature содержит sha256= и HMAC-SHA256 тела запроса секретом из настроек - проверяйте его, чтобы не принять чужой запрос. Ожидается ответ 2xx в течение 10 секунд; при ошибке радар напишет об этом в журнал рассылки и повторит события в следующий запуск вместе с новыми.