Fluxer


Schemes	`fluxer://`, `fluxers://`
Cargo feature	`service-fluxer`
Service	https://fluxer.app/
Body formats	`text` (first is the default)
Attachments	yes
Title length	250 characters
Body length	1,750 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	yes

URL formats

{schema}://{webhook_id}/{webhook_token}
{schema}://{host}/{webhook_id}/{webhook_token}
{schema}://{host}:{port}/{webhook_id}/{webhook_token}
{schema}://{host}{path}{webhook_id}/{webhook_token}
{schema}://{host}:{port}{path}{webhook_id}/{webhook_token}
{schema}://{botname}@{webhook_id}/{webhook_token}
{schema}://{botname}@{host}:{port}/{webhook_id}/{webhook_token}
{schema}://{botname}@{host}:{port}{path}{webhook_id}/{webhook_token}

{schema} is one of fluxer://, fluxers://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{botname}`	Bot Name	string	no
`{host}`	Hostname	string	no
`{path}`	Path	string	no	`/api/`
`{port}`	Port	int, 1 to 65535	no
`{webhook_id}`	Webhook ID	string	yes		secret; must match `^[0-9]{10,}$`
`{webhook_token}`	Webhook Token	string	yes		secret; must match `^[A-Za-z0-9_\-]{16,}$`

Query parameters

Parameter	Meaning	Type	Default	Notes
`avatar`	Avatar Image	bool	`yes`
`avatar_url`	Avatar URL	string
`fields`	Use Fields	bool	`yes`
`flags`	Discord Flags	int, min 0
`footer`	Display Footer	bool	`no`
`footer_logo`	Footer Logo	bool	`yes`
`href`	URL	string		also `url`
`image`	Include Image	bool	`no`
`mode`	Mode	choice	`cloud` (usually; depends on the URL)	one of `cloud`, `private`
`name`	Bot Name	string		sets `{botname}`
`path`	Path	string		sets `{path}`
`ping`	Ping Users/Roles	list		separated by `,` or space
`thread`	Thread ID	string
`thread_name`	Thread Name	string
`tts`	Text To Speech	bool	`no`

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

fluxer://0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
fluxer://l2g@0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
fluxer://example.ca:123/0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
fluxers://example.ca/api/0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
https://api.fluxer.app/webhooks/0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
fluxers://example.ca:8443/custom/api/0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
fluxers://example.ca/0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB?path=/
fluxer://0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB?flags=1

Rejected URLs:

fluxer://
fluxer://:@/
fluxer://0000000000
fluxer://0000000000/abc

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'fluxer://0000000000/BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB'

Notes

Fluxer (fluxer://, fluxers://): messages to a Fluxer channel through a webhook.

Cloud: fluxer://[botname@]{webhook_id}/{webhook_token}. Self-hosted: fluxers://[botname@]{host}[:port][/path]/{webhook_id}/{webhook_token} (/api/ is the default path, ?path=/ selects the host root).