Trigv
| Schemes | trigv://, trigvs:// |
| Cargo feature | service-trigv |
| Service | https://trigv.com/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | 255 characters |
| Body length | 1,000 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{api_key}
{schema}://{api_key}/{targets}
{schema}://{api_key}@{host}/{targets}
{schema}://{api_key}@{host}:{port}/{targets}
{schema}://{api_key}@{host}
{schema} is one of trigv://, trigvs://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{api_key} | API Key | string | yes | secret; must match ^trgv_[a-zA-Z0-9]{8}_[a-zA-Z0-9]{32}$ | |
{host} | API Hostname | string | no | ||
{port} | Port | int, 1 to 65535 | no | ||
{target_channel} | Target Channel | string | no | ||
{targets} | Targets | list | no | any of target_channel; separated by / |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
event_type | Event type | string | ||
image_url | Image URL | string | ||
priority | Priority (Pushover compatibility) | int | ||
to | Targets | list | sets {targets} | |
urgency | Urgency | choice | standard | one of standard, time_sensitive |
url | URL | 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):
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef/general
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef/ops/alerts
trigv://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef@trigv-platform.test/general
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef@trigv-platform.test:8443/general
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef/?priority=1
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef/alerts/?to=ops,escalation
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef/?urgency=TIME_SENSITIVE
Rejected URLs:
trigvs://
trigv://
trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef/?urgency=now
trigvs://not-a-valid-key
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'trigvs://trgv_a1b2c3d4_0123456789abcdef0123456789abcdef'
Notes
Trigv (trigv://, trigvs://): notifications through Trigv.