Prowl


Schemes	`prowl://`
Cargo feature	`service-prowl`
Service	https://www.prowlapp.com/
Body formats	`text` (first is the default)
Attachments	no
Title length	1,024 characters
Body length	10,000 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{apikey}
{schema}://{apikey}/{providerkey}

{schema} is one of prowl://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{apikey}`	API Key	string	yes		secret; must match `^[A-Za-z0-9]{40}$`
`{providerkey}`	Provider Key	string	no		secret; must match `^[A-Za-z0-9]{40}$`

Query parameters

Parameter	Meaning	Type	Default	Notes
`priority`	Priority	choice	`0`	one of `-2`, `-1`, `0`, `1`, `2`

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

prowl://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
prowl://wwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwwww///
prowl://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb
prowl://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?priority=high

Rejected URLs:

prowl://
prowl://:@/
prowl://aaaaaaaaaaaaaaaaaaaa
prowl://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/bbbbbbbbbbbbbbbbbbbb

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'prowl://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'

Notes

Prowl (prowl://): push notifications through Prowl.