Nextcloud

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

GitHub下载地址
(0)

本文由 橙叶博客 作者:FrankGreg 发表,转载请注明来源!

热评文章

发表评论