Lauther


Schemes	`lauther://`
Cargo feature	`service-lauther`
Service	https://lauther.app/
Body formats	`text` (first is the default)
Attachments	no
Title length	250 characters
Body length	2,000 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{token}

{schema} is one of lauther://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{token}`	Token	string	yes		secret; must match `^lpt_[a-z0-9]+$`

Query parameters

Parameter	Meaning	Type	Default	Notes
`click`	Click URL	string
`color`	Color	string
`group`	Group	string
`icon`	Icon URL	string
`priority`	Priority	choice	`0`	one of `-2`, `-1`, `0`, `1`, `2`
`route`	Route	string
`sound`	Sound	string
`token`	Token	string		sets `{token}`

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

lauther://lpt_abc123
lauther://lpt_abc123?priority=high
lauther://?token=lpt_abc123
lauther://lpt_abc123?sound=default&click=https://example.ca&icon=https%3A%2F%2Fi.ca%2Fx.png&color=red&group=g1&route=%2Fhome

Rejected URLs:

lauther://
lauther://:@/
lauther://%badtoken%
lauther://abc123

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'lauther://lpt_abc123'

Notes

Lauther (lauther://): push notifications through the Lauther API.