Pushy
| Schemes | pushy:// |
| Cargo feature | service-pushy |
| Service | https://pushy.me/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | 250 characters |
| Body length | 4,096 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{apikey}/{targets}
{schema} is one of pushy://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{apikey} | Secret API Key | string | yes | secret | |
{target_device} | Target Device | string | no | prefix @ | |
{target_topic} | Target Topic | string | no | prefix # | |
{targets} | Targets | list | yes | any of target_device, target_topic; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
badge | Badge | int, min 0 | ||
key | Secret API Key | string | sets {apikey} | |
sound | Sound | string | ||
to | Targets | list | sets {targets} |
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):
pushy://apikey/topic
pushy://apikey/@device
pushy://apikey/device/?badge=100
pushy://apikey/?to=@device
pushy://_/@device/#topic?key=apikey
pushy://apikey/device/?sound=alarm.aiff
Rejected URLs:
pushy://
pushy://:@/
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'pushy://apikey/topic'
Notes
Pushy (pushy://): push notifications through Pushy.