Aprs
| Schemes | aprs:// |
| Cargo feature | service-aprs |
| Service | https://www.aprs2.net/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | no title (merged into the body) |
| Body length | 67 characters |
| Body lines | unlimited |
| Request throttle | 800 ms between requests |
| Vendor URLs accepted | no |
URL formats
{schema}://{user}:{password}@{targets}
{schema} is one of aprs://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{password} | Password | string | yes | secret | |
{target_callsign} | Target Callsign | string | no | must match ^[a-z0-9]{2,5}(-[a-z0-9]{1,2})?$ | |
{targets} | Targets | list | yes | any of target_callsign; separated by / | |
{user} | User Name | string | yes |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
delay | Resend Delay | float, 0 to 5 | 0.0 | |
locale | Locale | choice | EURO | one of NOAM, SOAM, EURO, ASIA, AUNZ, ROTA |
to | Target Callsign | string |
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):
aprs://DF1JSL-15:12345@DF1ABC
aprs://DF1JSL-15:12345@DF1ABC/DF1DEF
aprs://DF1JSL-15:12345@DF1ABC-1/DF1ABC/DF1ABC-15
aprs://DF1JSL-15:12345@DF1ABC?locale=EURO
aprs://DF1JSL-15:12345@?to=DF1ABC,DF1DEF
aprs://DF1JSL-15:12345@DF1ABC?locale=noam&delay=0.1
Rejected URLs:
aprs://
aprs://:@/
aprs://DF1JSL-15:12345
aprs://DF1JSL-15@DF1ABC
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'aprs://DF1JSL-15:12345@DF1ABC'
Notes
APRS (aprs://): text messages to amateur radio call signs through APRS-IS.
One TCP connection to the regional APRS-IS server (port 10152): the user ... pass ... vers ... login, the server’s # logresp check, then one message packet per call sign: FROMCALL>APPRIS::TOCALL :text (text cleaned and cut to 67 chars).
Differences with Apprise
- The login names the software
mercurio <version>(Apprise:apprise <version>). - When the first read holds only the server banner, mercurio reads once more for the
# logrespline (Apprise fails). - The 0.8 s (+
delay) wait applies between the message packets of one notification, not between login and the first packet.