Одна интеграция — разные платформы.
Linux-сервер может отправить событие, а сотрудник — получить его на Windows. Windows-задача может уведомить коллегу на macOS. Операционная система источника не определяет устройство получателя.
Откуда приходит событие
| Среда | Пример | Как подключить |
|---|---|---|
| Windows: рабочая станция или сервер | Отчёт, импорт, резервная копия, Планировщик заданий. | PowerShell, Python или HTTP-клиент вашей программы. |
| Linux: сервер или рабочая станция | Мониторинг, cron/systemd-задача, pipeline. | curl, Python 3, Node.js или backend. |
| macOS | Локальный скрипт, автоматизация или рабочая задача. | Терминал Zsh/Bash, Python 3, Node.js или HTTP-клиент. |
| Сайт или внешняя система | Форма, заявка, событие приложения. | JS-сниппет или серверный POST. |
API использует HTTPS и JSON. Linux не ограничен сервером, а Windows — домашним компьютером. У источника должен быть сетевой доступ к API и возможность выполнить выбранную программу.
Первый запрос для вашей платформы
Windows: откройте PowerShell. Linux или macOS: откройте терминал. Замените ключ проекта и, для тестовой установки, адрес API.
Windows · PowerShell
$body = @{ event = "Проверка подключения"; meta = @{ source = "quick-start" } } | ConvertTo-Json
Invoke-RestMethod -Uri "https://app.ontik.ru/v1/events" -Method Post -Headers @{"X-Ontik-Key"="pk_live_ВАШ_КЛЮЧ"} -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))Linux · Bash
curl --fail-with-body --max-time 10 'https://app.ontik.ru/v1/events' \
-H 'X-Ontik-Key: pk_live_ВАШ_КЛЮЧ' \
-H 'Content-Type: application/json' \
-d '{"event":"Проверка подключения","meta":{"source":"quick-start"}}'macOS · Zsh / Bash
curl --fail-with-body --max-time 10 'https://app.ontik.ru/v1/events' \
-H 'X-Ontik-Key: pk_live_ВАШ_КЛЮЧ' \
-H 'Content-Type: application/json' \
-d '{"event":"Проверка подключения","meta":{"source":"quick-start"}}'Один Python-файл, разные команды
Учебный код из статей работает с библиотеками Python 3 без привязки к ОС. В Windows команда обычно python; если доступен только Python Launcher, используйте py -3. В Linux/macOS в инструкциях используется python3. Установите Python 3 отдельно, если команда не найдена.
Файл скачивается одинаковый: сохраните его с расширением .py, перейдите в его каталог и выполните команду из соответствующей вкладки. На Windows проверьте, что файл не получил окончание .py.txt.
Запуск по расписанию
В Windows используйте Планировщик заданий, в Linux — подходящий вам cron или systemd timer, в macOS — launchd либо вашу систему автоматизации. Расписание и окружение задаются вне Ontik. Укажите полный путь к интерпретатору и скрипту, рабочий каталог и переменные окружения: интерактивный терминал и планировщик могут использовать разные настройки.
Где получать результат
Лента событий доступна в веб-кабинете. Для Web Push дополнительно нужны поддержка браузера, HTTPS, разрешение уведомлений и активная подписка аккаунта. Баннер и его расположение зависят от ОС: демонстрация справа внизу показывает принцип работы, а не гарантированное оформление системного push.
| Устройство | Что учитывать |
|---|---|
| Windows, Linux, macOS | Браузер должен поддерживать Push API, Service Worker и Notifications. Проверьте разрешение сайта, системные уведомления и режим «Не беспокоить». |
| Android | Поддержка зависит от браузера; уведомления должны быть разрешены и в браузере, и в настройках Android. Доставка может зависеть от фоновых ограничений. |
| iPhone / iPad | WebKit предусматривает Web Push для веб-приложений, добавленных на домашний экран, начиная с iOS/iPadOS 16.4. Обычная вкладка не равнозначна этому режиму. |
Условия iPhone/iPad описаны в официальной публикации WebKit. Это возможность платформы, а не подтверждённая совместимость Ontik: подготовка installable web app и проверка кабинета на реальных iPhone/iPad ещё не завершены. Пока не обещаем Web Push на каждом мобильном устройстве.
Порядок включения и проверки Web Push →