WPUSH


Schemes	`wpush://`
Cargo feature	`service-wpush`
Service	https://wpush.cn/
Body formats	`text` (first is the default)
Attachments	no
Title length	255 characters
Body length	10,000 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	yes

URL formats

{schema}://{apikey}
{schema}://{apikey}/{targets}

{schema} is one of wpush://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{apikey}`	API Key	string	yes		secret; must match `^WPUSH[a-z0-9]{27}$`
`{targets}`	Topics	list	no		separated by `/`

Query parameters

Parameter	Meaning	Type	Notes
`apikey`	API Key	string	sets `{apikey}`
`channel`	Channel	list	separated by `,` or space; one of `wechat`, `app`, `sms`, `mail`, `webhook`, `dingtalk`, `feishu`, `wechat_work`, `clawbot`, `qqbot`
`group`	Group / Option Code	string	also `option`
`to`	Topics	list	sets `{targets}`
`topic`	Topics	list	sets `{targets}`
`topic_code`	Topics	list	sets `{targets}`
`url`	Click 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):

wpush://WPUSHabcdefghijklmnopqrstuvwxyz0
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0/topic2/topic1
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0?channel=FEISHU
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0?option=a&group=b
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0?url=https://example.com/
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0?channel=qqbot&group=123456
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0?channel=qqbot&option=123456
wpush://?apikey=WPUSHabcdefghijklmnopqrstuvwxyz0

Rejected URLs:

wpush://
wpush://short
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0?channel=invalid
wpush://WPUSHabcdefghijklmnopqrstuvwxyz0?group=123456&topic_code=mytopic

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'wpush://WPUSHabcdefghijklmnopqrstuvwxyz0'

Notes

WPUSH (wpush://): push notifications through WPUSH.