Nextcloud 站内信插件：Admin notifications

简介

这款插件允许管理员以站内信的形式向其它用户发送信息。

使用方法

这款插件可以借助HTTP endpoint或OCC命令发送站内信。

OCC命令

OCC命令详细使用方法参见：ownCloud/Nextcloud OCC命令行工具详解（1）

Help：

$ sudo -u www-data ./occ notification:generate --help
Usage:
  notification:generate [options] [--] <user-id> <short-message>

Arguments:
  user-id                          #需要通知的用户ID
  short-message                    #短消息内容（最多255个字符）

Options:
  -l, --long-message=LONG-MESSAGE  #长消息内容（最多4000个字符） [默认为:""]

例子：

$ sudo -u www-data ./occ notification:generate \
  admin "Short message up to 255 characters" \
  -l "Optional: longer message with more details, up to 4000 characters"

HTTP请求

Help:

curl -H "OCS-APIREQUEST: true" -X POST \ https://<admin-user>:<admin-app-password-token>@<server-url>/ocs/v2.php/apps/admin_notifications/api/v1/notifications/<user-id> \ -d "shortMessage=<short-message>" \ -d "longMessage=<long-message>"

对照： admin-user: #具有管理员权限的用户的用户ID admin-app-password-token: #密码或“管理员用户”的“应用密码” server-url: #Nextcloud实例的根目录url user-id: #需要通知的用户ID short-message: #短消息内容（最多255个字符） long-message: #长消息内容（最多4000个字符）

例子：

curl -H "OCS-APIREQUEST: true" -X POST \
  https://admin:admin@localhost/ocs/v2.php/apps/admin_notifications/api/v1/notifications/admin \
  -d "shortMessage=Short message up to 255 characters" \
  -d "longMessage=Optional: longer message with more details, up to 4000 characters"

状态码对照

状态码	含义
200	信息发送成功
400	信息内容太长或短消息内容为空
404	未知的用户（用户ID错误）
500	意外的服务器错误
503	Nextcloud实例处于维护模式

下载和支持

apps.nextcloud：https://apps.nextcloud.com/apps/admin_notifications

GitHub：https://github.com/nextcloud/admin_notifications

[scbutton link=“https://github.com/nextcloud/admin_notifications/archive/master.zip” target=“blank” variation=“blue” class=“icon-download”]GitHub下载地址[/scbutton]