Nextcloud 站内信插件：Admin notifications

Apr. 1, 2017

简介

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

 

使用方法

这款插件可以借助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]