| Schemes | x://, twitter://, tweet:// |
| Cargo feature | service-twitter |
| Service | https://twitter.com/ |
| Body formats | text (first is the default) |
| Attachments | yes |
| Title length | no title (merged into the body) |
| Body length | 10,000 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{ckey}/{csecret}/{akey}/{asecret}
{schema}://{ckey}/{csecret}/{akey}/{asecret}/{targets}
{schema} is one of x://, twitter://, tweet://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{akey} | Access Key | string | yes | secret | |
{asecret} | Access Secret | string | yes | secret | |
{ckey} | Consumer Key | string | yes | secret | |
{csecret} | Consumer Secret | string | yes | secret | |
{target_user} | Target User | string | no | prefix @ | |
{targets} | Targets | list | no | any of target_user; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
batch | Batch Mode | bool | yes | |
cache | Cache Results | bool | yes | |
mode | Message Mode | choice | dm (usually; depends on the URL) | one of dm, tweet |
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):
tweet://ckey/csecret/akey/asecret
twitter://ckey/csecret/akey/asecret
twitter://ckey/csecret/akey/asecret/-/usera
x://ckey/csecret/akey/asecret?mode=dm
twitter://usera@ckey/csecret/akey/asecret?cache=no
twitter://ckey/csecret/akey/asecret?mode=tweet
twitter://ckey/csecret/akey/asecret/usera?mode=tweet
twitter://ckey/csecret/akey/asecret?mode=tweet&batch=no
Rejected URLs:
twitter://
twitter://:@/
twitter://consumer_key
twitter://consumer_key/consumer_secret/atoken1/
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'tweet://ckey/csecret/akey/asecret'
Notes
Twitter / X (x://, twitter://, tweet://): direct messages and public tweets through the X API v2, with image uploads; requests are signed with OAuth 1.0a HMAC-SHA1 (header signature, body never signed).