XML
| Schemes | xml://, xmls:// |
| Cargo feature | service-xml |
| Body formats | text, html, markdown (first is the default) |
| Attachments | yes |
| Title length | 250 characters |
| Body length | 32,768 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{host}
{schema}://{host}:{port}
{schema}://{user}@{host}
{schema}://{user}@{host}:{port}
{schema}://{user}:{password}@{host}
{schema}://{user}:{password}@{host}:{port}
{schema} is one of xml://, xmls://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{host} | Hostname | string | yes | ||
{password} | Password | string | no | secret | |
{port} | Port | int, 1 to 65535 | no | ||
{user} | Username | string | no |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
method | Fetch Method | choice | POST | one of POST, GET, DELETE, PUT, HEAD, PATCH, UPDATE, OPTIONS |
Prefixed parameters:
+name=value: HTTP Header-name=value: GET Params:name=value: Payload Extras
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):
xml://localhost
xmls://user:pass@localhost:8080/path/to/hook
xml://localhost/?+X-Custom=yes&method=put
xml://localhost/?:Subject=Title&:Message=&:Extra=val&:bad!!key=x&:!!!=y
Rejected URLs:
xml://localhost/?method=invalid
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'xml://localhost'
Notes
XML webhook (xml://, xmls://): posts the notification as a SOAP/XML document to any HTTP endpoint.