Gotify
| Schemes | gotify://, gotifys:// |
| Cargo feature | service-gotify |
| Service | https://github.com/gotify/server |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | 250 characters |
| 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}://{host}{path}{token}
{schema}://{host}:{port}{path}{token}
{schema} is one of gotify://, gotifys://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{host} | Hostname | string | yes | ||
{path} | Path | string | no | / | |
{port} | Port | int, 1 to 65535 | no | ||
{token} | Token | string | yes | secret |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
priority | Priority | choice | 5 | one of 0, 3, 5, 8, 10 |
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):
gotify://hostname/abcd1234
gotifys://user:pass@hostname:8443/a/path/abcd1234/
gotifys://hostname/abcd1234?verify=no
gotify://hostname/abcd1234?priority=high
gotify://hostname/abcd1234?format=markdown
Rejected URLs:
gotify://hostname
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'gotify://hostname/abcd1234'
Notes
Gotify (gotify://, gotifys://): push messages to a Gotify server.