Twist
| Schemes | twist:// |
| Cargo feature | service-twist |
| Service | https://twist.com |
| Body formats | markdown (first is the default) |
| Attachments | no |
| Title length | 250 characters |
| Body length | 1,000 characters |
| Body lines | unlimited |
| Request throttle | 200 ms between requests |
| Vendor URLs accepted | no |
URL formats
{schema}://{password}:{email}
{schema}://{password}:{email}/{targets}
{schema} is one of twist://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{email} | yes | ||||
{password} | Password | string | yes | secret | |
{target_channel} | Target Channel | string | no | prefix # | |
{target_channel_id} | Target Channel ID | string | no | ||
{targets} | Targets | list | no | any of target_channel, target_channel_id; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
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):
twist://password:user@example.com
twist://user@example.com/secret/42
twist://password:user@example.com/12345
twist://password:user@example.com?to=777
twist://password:user@example.com/12345?overflow=split
Rejected URLs:
twist://
twist://:@/
twist://user@example.com/
twist://password:user@exa_mple!.com
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'twist://password:user@example.com'
Notes
Twist (twist://): messages to Twist threads and channels.
The login session lives on the parsed URL: the token, workspace and channel lookups are kept between sends (channel names are resolved once). users/logout runs from Target::close.