Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

HumHub

Schemeshumhub://, humhubs://
Cargo featureservice-humhub
Servicehttps://www.humhub.com/
Body formatstext (first is the default)
Attachmentsyes
Title lengthno title (merged into the body)
Body length4,000 characters
Body linesunlimited
Request throttle20 ms between requests
Vendor URLs acceptedno

URL formats

{schema}://{user}@{host}/{targets}
{schema}://{user}@{host}:{port}/{targets}
{schema}://{user}:{password}@{host}/{targets}
{schema}://{user}:{password}@{host}:{port}/{targets}

{schema} is one of humhub://, humhubs://.

URL tokens

TokenMeaningTypeRequiredDefaultNotes
{host}Hostnamestringyes
{password}Passwordstringnosecret
{port}Portint, 1 to 65535no
{targets}Targetslistnoseparated by /
{user}Token or Usernamestringyessecret

Query parameters

ParameterMeaningTypeDefaultNotes
toTargetslistsets {targets}

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

humhub://mytoken@hostname/1
humhubs://mytoken@hostname/1
humhubs://mytoken@hostname/1/2/3
humhubs://mytoken@hostname/1/?to=2,3

Rejected URLs:

humhub://
humhub://hostname
humhub://token@hostname
humhubs://token@hostname/invalid

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'humhub://mytoken@hostname/1'

Notes

HumHub (humhub://, humhubs://): posts to HumHub spaces or user streams.

One post per container; attachments are uploaded to the post id the server returns. On ?retry=, containers already posted to are not posted again and only their missing attachments are uploaded to the remembered post id.