Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Gotify

Schemesgotify://, gotifys://
Cargo featureservice-gotify
Servicehttps://github.com/gotify/server
Body formatstext (first is the default)
Attachmentsno
Title length250 characters
Body length32,768 characters
Body linesunlimited
Request throttlenone
Vendor URLs acceptedno

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

TokenMeaningTypeRequiredDefaultNotes
{host}Hostnamestringyes
{path}Pathstringno/
{port}Portint, 1 to 65535no
{token}Tokenstringyessecret

Query parameters

ParameterMeaningTypeDefaultNotes
priorityPrioritychoice5one 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.