Pinglet


Schemes	`pinglet://`, `pinglets://`
Cargo feature	`service-pinglet`
Service	https://pinglet.co.uk/
Body formats	`text` (first is the default)
Attachments	no
Title length	250 characters
Body length	3,000 characters
Body lines	unlimited
Request throttle	500 ms between requests
Vendor URLs accepted	no

URL formats

{schema}://{token}@{host}/{namespace}/{topic}
{schema}://{token}@{host}:{port}/{namespace}/{topic}
{schema}://{token}@{host}{path}{namespace}/{topic}
{schema}://{token}@{host}:{port}{path}{namespace}/{topic}

{schema} is one of pinglet://, pinglets://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{host}`	Hostname	string	yes
`{namespace}`	Namespace	string	yes
`{path}`	Path	string	no	`/`
`{port}`	Port	int, 1 to 65535	no
`{token}`	API Key	string	yes		secret
`{topic}`	Topic	string	yes

Query parameters

Parameter	Meaning	Type	Default	Notes
`priority`	Priority	choice	`normal`	one of `silent`, `normal`, `urgent`
`token`	API Key	string		sets `{token}`

Prefixed parameters:

:name=value: Badges
+name=value: Metadata

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

pinglet://abc123@hostname/acme/deploys
pinglets://abc123@hostname/acme/deploys
pinglet://abc123@hostname/prefix/sub/acme/deploys/
pinglets://hostname/acme/deploys?token=abc123
pinglet://abc123@hostname/acme/deploys?priority=urgent
pinglet://abc123@hostname/acme/deploys?:a=1&:b=2&:c=3&:d=4
pinglet://abc123@hostname/acme/deploys?:CPU=95%25&+region=eu-west

Rejected URLs:

pinglet://
pinglet://:@/
pinglet://hostname/acme/deploys
pinglet://token@hostname

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'pinglet://abc123@hostname/acme/deploys'

Notes

Pinglet (pinglet://, pinglets://): notifications through Pinglet.