Synology Chat


Schemes	`synology://`, `synologys://`
Cargo feature	`service-synology`
Service	https://www.synology.com/
Body formats	`text` (first is the default)
Attachments	no
Title length	no title (merged into the body)
Body length	32,768 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

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

{schema} is one of synology://, synologys://.

URL tokens

Token	Meaning	Type	Required	Notes
`{host}`	Hostname	string	yes
`{password}`	Password	string	no	secret
`{port}`	Port	int, 1 to 65535	no
`{token}`	Token	string	yes	secret
`{user}`	Username	string	no

Query parameters

Parameter	Meaning	Type	Default	Notes
`file_url`	Upload	string
`token`	Token	string		sets `{token}`

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):

synology://localhost/token
synologys://localhost/token
synology://user:pass@localhost/token
synology://localhost/to%20ken/sub/dir
synologys://localhost:8080/token/path/
synologys://localhost?token=mytoken
synologys://localhost/?token=mytoken
synology://localhost/token?file_url=http://reddit.com/test.jpg

Rejected URLs:

synology://:@/
synology://
synologys://
synology://user@localhost

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'synology://localhost/token'

Notes

Synology Chat (synology://, synologys://): messages through Synology Chat incoming webhooks.

Differences with Apprise

Apprise crashes on URLs without a path, while mercurio handles them.

Keyboard shortcuts