MSC4213: Remove server_name parameter

Signed-off-by: Johannes Marbach <n0-0ne+github@mailbox.org>
This commit is contained in:
Johannes Marbach 2025-01-21 09:15:09 +01:00
parent d0d71d9997
commit 1a31a12cba
3 changed files with 2 additions and 52 deletions

View file

@ -900,8 +900,8 @@ A room (or room permalink) which isn't using a room alias should supply
at least one server using `via` in the URI's query string. Multiple servers at least one server using `via` in the URI's query string. Multiple servers
can be specified by including multuple `via` parameters. can be specified by including multuple `via` parameters.
The values of `via` are intended to be passed along as the `server_name` The values of `via` are intended to be passed along on the
parameters on the [Client Server `/join/{roomIdOrAlias}` API](/client-server-api/#post_matrixclientv3joinroomidoralias). [Client Server `/join/{roomIdOrAlias}` API](/client-server-api/#post_matrixclientv3joinroomidoralias).
When generating room links and permalinks, the application should pick When generating room links and permalinks, the application should pick
servers which have a high probability of being in the room in the servers which have a high probability of being in the room in the

View file

@ -137,31 +137,6 @@ paths:
example: "#monkeys:matrix.org" example: "#monkeys:matrix.org"
schema: schema:
type: string type: string
- in: query
name: server_name
deprecated: true
x-changedInMatrixVersion:
"1.12": |-
This parameter has been deprecated in favour of `via` and will be removed in
a future version of the spec.
Clients SHOULD use `via` when the homeserver they're talking to supports it.
To do this, they MAY either detect server support through the supported spec
versions in [`/_matrix/client/versions`](/client-server-api/#get_matrixclientversions)
or always include both parameters with identical values.
Homeservers MUST ignore all `server_name` parameters if any `via` parameters
are supplied.
description: |-
The servers to attempt to join the room through. One of the servers
must be participating in the room.
example:
- matrix.org
- elsewhere.ca
schema:
type: array
items:
type: string
- in: query - in: query
name: via name: via
x-addedInMatrixVersion: "1.12" x-addedInMatrixVersion: "1.12"

View file

@ -48,31 +48,6 @@ paths:
example: "#monkeys:matrix.org" example: "#monkeys:matrix.org"
schema: schema:
type: string type: string
- in: query
name: server_name
deprecated: true
x-changedInMatrixVersion:
"1.12": |-
This parameter has been deprecated in favour of `via` and will be removed in
a future version of the spec.
Clients SHOULD use `via` when the homeserver they're talking to supports it.
To do this, they MAY either detect server support through the supported spec
versions in [`/_matrix/client/versions`](/client-server-api/#get_matrixclientversions)
or always include both parameters with identical values.
Homeservers MUST ignore all `server_name` parameters if any `via` parameters
are supplied.
description: |-
The servers to attempt to knock on the room through. One of the servers
must be participating in the room.
example:
- matrix.org
- elsewhere.ca
schema:
type: array
items:
type: string
- in: query - in: query
name: via name: via
x-addedInMatrixVersion: "1.12" x-addedInMatrixVersion: "1.12"