Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-01-11 18:13:42 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Add unstable endpoint replacements

Browse source
This commit is contained in:
Andrew Morgan 2020-09-16 15:57:12 +01:00
parent fd9d57b8c4
commit 6e47e86f01
1 changed files with 22 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
proposals/2403-knock.md
View file

@ -412,3 +412,25 @@ knocks over and over.
In both cases, room admins should employ typical abuse mitigation tools, such
as user bans and server ACLs. Clients are encouraged to ease employing these
tools easy even if the offensive user or server is present not in the room.
# Unstable prefix
An unstable feature flag is added to the `unstable_features` dict of
`/_matrix/client/versions` with the key `xyz.amorgan.knock` and value `true`.
If this key is present, this is a signal to clients that the homeserver has
experimental support for room knocking.
The new endpoints should contain an unstable prefix during experimental
implementation. The unstable counterpart for each endpoint is:
* `POST /_matrix/client/r0/rooms/{roomId}/knock`
* `POST /_matrix/client/unstable/xyz.amorgan/rooms/{roomId}/knock`
* `POST /_matrix/client/knock/{roomIdOrAlias}`
* `POST /_matrix/client/unstable/xyz.amorgan/knock/{roomIdOrAlias}`
* `GET /_matrix/federation/v1/make_knock/{roomId}/{userId}`
* `GET /_matrix/federation/unstable/xyz.amorgan/make_knock/{roomId}/{userId}`
* `PUT /_matrix/federation/v1/send_knock/{roomId}/{eventId}`
* `PUT /_matrix/federation/unstable/xyz.amorgan/send_knock/{roomId}/{eventId}`