Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

httpSMS

Schemeshttpsms://
Cargo featureservice-httpsms
Servicehttps://httpsms.com
Body formatstext (first is the default)
Attachmentsno
Title lengthno title (merged into the body)
Body length160 characters
Body linesunlimited
Request throttlenone
Vendor URLs acceptedno

URL formats

{schema}://{apikey}@{from_phone}
{schema}://{apikey}@{from_phone}/{targets}

{schema} is one of httpsms://.

URL tokens

TokenMeaningTypeRequiredDefaultNotes
{apikey}API Keystringyessecret
{from_phone}From Phone Nostringyesmust match ^\+?[0-9\s)(+-]+$
{target_phone}Target Phone Nostringnoprefix +; must match ^[0-9\s)(+-]+$
{targets}Targetslistyesany of target_phone; separated by /

Query parameters

ParameterMeaningTypeDefaultNotes
fromFrom Phone Nostringmust match ^\+?[0-9\s)(+-]+$
keyAPI Keystringsets {apikey}
toTargetslistsets {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):

httpsms://apikey@15551232000
httpsms://apikey@15551232000/15551232001/15551232002
httpsms://user@15551232000?key=thekey
httpsms://apikey@15551232001?from=15551232000
httpsms://apikey@15551232000?to=15551232003,15551232004

Rejected URLs:

httpsms://
httpsms://15551232000
httpsms://%20@15551232000
httpsms://apikey@555

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'httpsms://apikey@15551232000'

Notes

httpSMS (httpsms://): SMS sent from your Android phone through the httpSMS API.