API Дозора: подключение к n8n

Один ключ — для всех действий Дозора, которые разрешены этому ключу и доступны через API. Его не нужно создавать заново для каждой Подборки, страницы или проверки.

В n8n ключ сохраняется один раз. Затем его можно выбрать в разных блоках HTTP Request: один блок покажет результаты, другой — источники. Новый блок не означает новый ключ. Отдельного готового блока «Дозор» в n8n пока нет.

1. Создайте ключ в Дозоре

В кабинете откройте «Настройки → API для вашего аккаунта».
Назовите ключ, например «Мой n8n». Для первой проверки оставьте право «Читать данные» и дневной лимит 0 кредитов. Так можно проверить подключение без платного запуска.
Нажмите «Создать API-ключ» и сразу скопируйте его. Целиком он показывается только один раз. Не отправляйте ключ в переписке и не вставляйте его в общедоступную страницу.

2. Подключите ключ в n8n

В новом неопубликованном сценарии добавьте блок HTTP Request.
Укажите метод GET и адрес https://dozorsites.com/api/v1/account.
В поле Authentication выберите Generic Credential Type → Bearer Auth и создайте учётные данные с названием «Дозор». В поле Bearer Token вставьте только сам ключ — слово Bearer дописывать не нужно.
Сохраните учётные данные и запустите только этот блок вручную. Если подключение работает, n8n покажет данные вашего аккаунта. Запрос ничего не меняет и не списывает кредиты.

В другой программе принцип тот же: сохраните ключ в её защищённых настройках и передавайте его в заголовке Authorization: Bearer ВАШ_КЛЮЧ. Адреса Дозора начинаются с https://dozorsites.com/api/v1/.

3. Используйте тот же ключ для других данных

Добавьте ещё один блок HTTP Request, выберите те же учётные данные «Дозор» и поменяйте только адрес действия:

Посмотреть источникиGET /api/v1/local-sources

Посмотреть ПодборкиGET /api/v1/collection-groups

Посмотреть результаты проверокGET /api/v1/monitor-results

Посмотреть историюGET /api/v1/history

Это адреса для просмотра, а не «допуски». Допуски — три права, которые вы выбираете при создании ключа: чтение, управление услугами и запуск сбора. Если позднее понадобятся другие права или дневной бюджет, создайте новый ключ с нужными настройками; существующий ключ сейчас можно только отозвать.

Платный запуск пока не нужен для проверки подключения. Не включайте в n8n расписание или повтор запросов, пока не проверите один ручной запуск и не зададите осознанный лимит кредитов.

Если понадобится запускать проверки и сбор материалов

Создайте отдельный ключ с правом «Запускать сбор и проверки» и дневным лимитом больше 0. Этот ключ можно сохранить в n8n так же, как ключ для чтения. Для каждой команды запуска выберите нужный адрес и укажите ограничения списания. Право запуска не перезапускает сайт.

Для запуска конкретного сохранённого источника используется запрос ниже. Вместо ID подставьте идентификатор источника из списка /local-sources. Сначала проверьте его вручную без расписания.

POST https://dozorsites.com/api/v1/local-sources/ID/check
Idempotency-Key: check-2026-09-18-001
X-Max-Credits: 3

Idempotency-Key — код одного действия: при повторной попытке того же запуска используйте тот же код, а для нового запуска — новый. X-Max-Credits: 3 не позволит списать более 3 кредитов в рамках запроса; если лимита не хватит, запрос может завершиться ошибкой. Дневной лимит ключа отдельно ограничивает общий расход за день. Оба заголовка указываются в блоке HTTP Request; сам API-ключ продолжает передаваться через сохранённые учётные данные.

Техническая справка: все адреса для чтения

Команда GET означает «показать данные»: она не создаёт Подборку, не запускает проверку и не списывает кредиты. Для каждого адреса используйте тот же API-ключ.

Адрес запроса	Что получите
`GET /api/v1/account`	Данные своего аккаунта, доступный баланс и историю кредитных операций.
`GET /api/v1/local-sources`	Список своих источников под наблюдением: страницы, сайты, каналы, их настройки и состояние.
`GET /api/v1/collection-groups`	Свои Подборки по темам вместе с их источниками.
`GET /api/v1/collections`	Разделы Подборок по видам материалов — например, статьи и видео — с их параметрами.
`GET /api/v1/monitor-results`	Архив результатов проверок страниц и других объектов мониторинга: были ли изменения и ошибки.
`GET /api/v1/history`	Историю событий и запусков, в том числе сбора материалов.
`GET /api/v1/notifications`	Свои уведомления и состояние доставки в кабинет, Telegram или на почту.
`GET /api/v1/pricing`	Действующие правила стоимости доступных услуг.
`GET /api/v1/service-orders`	Свои заявки на пополнение и дополнительные услуги с их статусами.
`GET /api/v1/price-monitoring/monitors`	Список своих заданий по ценам и товарам, их настройки и состояние.

Если данных пока нет, вернётся пустой список. Некоторые адреса принимают дополнительные фильтры, например тип источника или число записей.

Ограничения и частые ошибки

Через API сейчас доступны не все функции кабинета. Расписание Дозора, согласие на автоматические проверки, настройки доставки и браузерное расширение настраиваются в кабинете. Для защищённых магазинов расширение должно работать в вашем браузере. n8n может повторять свои запросы по собственному расписанию, но только если вы это настроите сами и учтёте частоту и бюджет.

401 — ключ недействителен или отозван.
403 — у ключа нет нужного права или действие не открыто через API.
429 — превышена частота запросов; повторите позже.

Ключ не даёт административных прав и доступа к данным других клиентов. При подозрении на утечку отзовите его в настройках и создайте новый. Для использования API-ключа YooKassa не требуется; платные действия расходуют кредиты того же аккаунта.