SMS Eagle


Schemes	`smseagle://`, `smseagles://`
Cargo feature	`service-smseagle`
Service	https://smseagle.eu
Body formats	`text` (first is the default)
Attachments	yes
Title length	no title (merged into the body)
Body length	1,200 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{token}@{host}/{targets}
{schema}://{token}@{host}:{port}/{targets}

{schema} is one of smseagle://, smseagles://.

URL tokens

Token	Meaning	Type	Required	Notes
`{host}`	Hostname	string	yes
`{port}`	Port	int, 1 to 65535	no
`{target_contact}`	Target Contact	string	no	prefix `@`; must match `^[a-z0-9_-]+$`
`{target_group}`	Target Group ID	string	no	prefix `#`; must match `^[a-z0-9_-]+$`
`{target_phone}`	Target Phone No	string	no	prefix `+`; must match `^[0-9\s)(+-]+$`
`{targets}`	Targets	list	yes	any of `target_contact`, `target_group`, `target_phone`; separated by `/`
`{token}`	Access Token	string	yes

Query parameters

Parameter	Meaning	Type	Default	Notes
`batch`	Batch Mode	bool	`no`
`flash`	Flash	bool	`no`
`priority`	Priority	choice	`0`	one of `0`, `1`
`status`	Show Status	bool	`no`
`test`	Test Only	bool	`no`
`to`	Targets	list		sets `{targets}`
`token`	Access Token	string		sets `{token}`

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):

smseagle://token@localhost/123456789
smseagles://token@localhost:8443/+12345678901
smseagle://token@localhost/123456789/987654321/111111111/@c1/@c2?batch=yes
smseagle://token@localhost/123456789?priority=high
smseagle://user:pass@localhost/123456789?token=abc&to=987654321
smseagle://token@localhost/123456789/@contact1/%23group1/#group2/contact2/!bad?status=yes&test=yes&flash=yes

Rejected URLs:

smseagle://
smseagle://localhost
smseagle://token@localhost/123456789?priority=invalid
smseagle://token@localhost/123456789?priority=5

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'smseagle://token@localhost/123456789'

Notes

SMSEagle (smseagle://, smseagles://): SMS through an SMSEagle device.