Matrix
URL 格式
matrix://user
:password
@host
:port
/[?rooms=!roomID1
[,roomAlias2
]][&disableTLS=yes]
URL 字段
User
- 用户名,使用访问令牌时为空
默认值:空
URL 部分:matrix://user:password@host/
Password
- 密码或访问令牌(必需)
URL 部分:matrix://user:password@host/
Host
(必需)
URL 部分:matrix://user:password@host/
查询/参数属性
参数可以通过 URL 查询参数提供:?key=value&key=value
等。
DisableTLS
默认值:❌ NoRooms - 房间别名,或以 ! 前缀的房间 ID
默认值:空
别名:room
身份验证
如果未指定 user
,则 password
将被视为身份验证令牌。这意味着无论您的服务器使用什么登录 流程,只要您能手动获取令牌,Shoutrrr 就可以使用它。
密码登录流程
如果提供了 user
和 password
,如果服务器支持,将尝试 m.login.password
登录流程。
房间
如果未指定 rooms
,服务将向用户当前加入的所有房间发送消息。
否则,服务将仅向指定的房间发送消息。如果用户尚未加入这些房间中的任何一个, 但已被邀请,它将自动接受该邀请。
注意:除非在 rooms
中明确指定,否则服务将不会加入任何房间。如果您需要用户 加入这些房间,您可以发送一次明确设置了 rooms
的通知。
房间查找
rooms
中指定的房间如果以 !
开头,将被视为房间 ID,并直接用于标识房间。如果 它们没有这样的前缀(或使用正确转义的 #
),它们将被视为别名,并且将使用目录 查询来解析它们对应的 ID。
注意:不要对频道别名使用未转义的 #
,因为它将被视为 URL 的 fragment
部分。 要么省略它们,要么对 URL 进行编码,例如 rooms=%23alias:server
或 rooms=alias:server
TLS
如果您的服务器上未启用 TLS,可以通过提供 disableTLS=yes
来禁用它。这将实际上 对 API 调用使用 http
而不是 https
。