Перейти к содержимому
Notifly Notifly

Отправка сообщений

Как уже было указано во Введении, вам нужен канал для отправки сообщений в Notifly. Только пользователь, создавший канал, может видеть его сообщения. Канал можно добавить через

  • WebUI: откройте раздел «Каналы» в боковом меню и нажмите «Создать канал»
  • REST API: curl -u admin:admin https://yourdomain.com/application -F "name=test" -F "description=tutorial" (URL application сохранён для совместимости с протоколом Gotify). См. Документацию API

Чтобы отправлять сообщения в канал, нужен app-токен этого канала. Токен возвращается в REST-запросе и виден в WebUI.

Теперь вы можете просто использовать curl, HTTPie или любой другой установленный HTTP-клиент для отправки сообщений.

Окно терминала
$ curl "https://push.example.de/message?token=<apptoken>" -F "title=my title" -F "message=my message" -F "priority=5"
$ http -f POST "https://push.example.de/message?token=<apptoken>" title="my title" message="my message" priority="5"

В Microsoft PowerShell вы можете использовать встроенные командлеты Invoke-RestMethod или Invoke-WebRequest.

Окно терминала
PS> Invoke-RestMethod -Uri "https://push.example.de/message?token=<apptoken>" -Method POST -Body @{title="my title"; message="my message"; priority=5} # результат автоматически разбирается в объект PowerShell
PS> Invoke-WebRequest -Uri "https://push.example.de/message?token=<apptoken>" -Method POST -Body @{title="my title"; message="my message"; priority=5} # результат как необработанный ответ

API сообщения принимает свойство extras, которое передаёт дополнительную информацию с сообщением и описывает, как клиенты ведут себя относительно этого сообщения. См. дополнительные поля сообщения для получения дополнительной информации.

Начиная с Notifly v1.2.0 требуется только параметр message.

Здесь ещё много примеров отправки сообщений на различных языках.

Совет: для интеграций из браузера, фронтенда и простых скриптов удобнее использовать вебхуки — токен в URL, без заголовков и без CORS-preflight.

Вы также можете использовать [Notifly CLI](https://github.com/Notifly CLI) для отправки сообщений. CLI сохраняет URL и токен в файле конфигурации.

Окно терминала
$ notifly push -t "my title" -p 10 "my message"
$ echo my message | notifly push

[Как установить Notifly CLI](https://github.com/Notifly CLI).