Nextcloud


Schemes	`ncloud://`, `nclouds://`
Cargo feature	`service-nextcloud`
Service	https://nextcloud.com/
Body formats	`text` (first is the default)
Attachments	no
Title length	255 characters
Body length	4,000 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{host}/{targets}
{schema}://{host}:{port}/{targets}
{schema}://{user}:{password}@{host}/{targets}
{schema}://{user}:{password}@{host}:{port}/{targets}

{schema} is one of ncloud://, nclouds://.

URL tokens

Token	Meaning	Type	Required	Notes
`{host}`	Hostname	string	yes
`{password}`	Password	string	no	secret
`{port}`	Port	int, 1 to 65535	no
`{target_group}`	Target Group	string	no	prefix `#`
`{target_user}`	Target User	string	no	prefix `@`
`{targets}`	Targets	list	yes	any of `target_group`, `target_user`; separated by `/`
`{user}`	Username	string	no

Query parameters

Parameter	Meaning	Type	Default	Notes
`to`	Targets	list		sets `{targets}`
`url_prefix`	URL Prefix	string
`version`	Version	int, min 1	`21`

Prefixed parameters:

+name=value: HTTP Header

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

ncloud://localhost/admin
ncloud://user@localhost/admin
ncloud://localhost/admin/@admin
nclouds://user:pass@localhost/admin
ncloud://user:pass@localhost/?to=*
ncloud://user@localhost?to=user1&version=20
ncloud://user@localhost?to=user1&version=20&url_prefix=/abcd
ncloud://localhost:8080/admin?+HeaderKey=HeaderValue&+Accept=text/plain

Rejected URLs:

ncloud://
ncloud://user@localhost?to=user1&version=invalid
ncloud://user@localhost?to=user1&version=0
ncloud://user@localhost?to=user1&version=-23

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'ncloud://localhost/admin'

Notes

Nextcloud (ncloud://, nclouds://): notifications to Nextcloud users.

Targets are users, #groups or all/everyone/*; groups are expanded through the OCS provisioning API before sending.

Group lookups are cached for a day in the persistent store.

Differences with Apprise

URL order is kept (users first, then group members); Apprise iterates unordered sets.

Keyboard shortcuts