Kook


Schemes	`kook://`
Cargo feature	`service-kook`
Service	https://www.kookapp.cn/
Body formats	`markdown` (first is the default)
Attachments	yes
Title length	no title (merged into the body)
Body length	5,000 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	yes

URL formats

{schema}://{token}
{schema}://{token}/{targets}

{schema} is one of kook://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{targets}`	Targets	list	no		separated by `/`
`{token}`	Token	string	yes		secret

Query parameters

Parameter	Meaning	Type	Default	Notes
`mode`	Mode	choice	`bot`	one of `bot`, `webhook`
`to`	Targets	list		sets `{targets}`
`token`	Token	string		sets `{token}`

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

kook://kookbottoken123/1234567890
kook://kookbottoken123/1234567890/@1111111111
https://www.kookapp.cn/api/v3/incoming/nativekey123
kook://kookbottoken123/9876543210/1234567890/1234567890
kook://kookbottoken123/@1111111111/%231234567890/bad/@x
kook://kookbottoken123/1234567890/?format=text
https://www.kookapp.cn/api/v3/incoming/nativekey123/?format=text
kook://abc123webhookkey/?mode=webhook

Rejected URLs:

kook://
kook://kookbottoken123/?mode=invalid

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'kook://kookbottoken123/1234567890'

Notes

Kook (kook://): messages through bot mode (channels, DMs, CDN attachments) and incoming-webhook mode.