GoAlert
| Schemes | goalert://, goalerts:// |
| Cargo feature | service-goalert |
| Service | https://goalert.me/ |
| Body formats | markdown (first is the default) |
| Attachments | no |
| Title length | 1,024 characters |
| Body length | 6,144 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{host}/{targets}
{schema}://{host}:{port}/{targets}
{schema}://{host}{path}{targets}
{schema}://{host}:{port}{path}{targets}
{schema} is one of goalert://, goalerts://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{host} | Hostname | string | yes | ||
{path} | Path | string | no | / | |
{port} | Port | int, 1 to 65535 | no | ||
{targets} | Integration Keys | list | yes | secret; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
action | Action | choice | map | one of map, trigger, close |
dedup | Deduplication Key | string | ||
to | Integration Keys | list | sets {targets} | |
token | Integration Keys | list | sets {targets} |
Prefixed parameters:
+name=value: Metadata
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):
goalert://localhost/a1b2c3d4-e5f6-7890-abcd-ef1234567890
goalert://localhost/my%20path/a1b2c3d4-e5f6-7890-abcd-ef1234567890
goalerts://localhost:8443/goalert/a1b2c3d4-e5f6-7890-abcd-ef1234567890/B1B2C3D4-E5F6-7890-ABCD-EF123456789C
goalert://localhost/a1b2c3d4-e5f6-7890-abcd-ef1234567890?action=t
goalerts://localhost/a1b2c3d4-e5f6-7890-abcd-ef1234567890?action=trigger&+env=prod&+Region=eu%20west
goalerts://localhost/?token=a1b2c3d4-e5f6-7890-abcd-ef1234567890&action=close&dedup=disk
goalert://localhost:8080/a/b/?to=a1b2c3d4-e5f6-7890-abcd-ef1234567890,invalid,c1b2c3d4-e5f6-7890-abcd-ef1234567890
Rejected URLs:
goalert://
goalerts://localhost/a1b2c3d4-e5f6-7890-abcd-ef1234567890?action=invalid
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'goalert://localhost/a1b2c3d4-e5f6-7890-abcd-ef1234567890'
Notes
GoAlert (goalert://, goalerts://): alerts through a GoAlert generic incoming integration.