Join
| Schemes | join:// |
| Cargo feature | service-join |
| Service | https://joaoapps.com/join/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | 250 characters |
| Body length | 1,000 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{apikey}/{targets}
{schema} is one of join://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{apikey} | API Key | string | yes | secret; must match ^[a-z0-9]{32}$ | |
{device} | Device ID | string | no | must match ^[a-z0-9]{32}$ | |
{device_name} | Device Name | string | no | ||
{group} | Group | choice | no | one of all, android, chrome, windows10, phone, tablet, pc | |
{targets} | Targets | list | yes | any of device, device_name, group; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
image | Include Image | bool | yes | |
priority | Priority | choice | 0 | one of -2, -1, 0, 1, 2 |
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):
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/MyDevice
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/android/PHONE/allthings
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/dddddddddddddddddddddddddddddddd/eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?image=no
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa@dddddddddddddddddddddddddddddddd?image=True
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?priority=high
join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa?to=dddddddddddddddddddddddddddddddd
Rejected URLs:
join://
join://:@/
join://abc
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'join://aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
Notes
Join (join://): push notifications to Join devices or device groups.