Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-07-02 12:17:47 +02:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Indicate spec version for changes

Browse source 
Signed-off-by: Hagen Echzell <hagene@uio.no>
This commit is contained in:
Hagen Echzell 2026-06-25 15:52:20 +02:00
parent 2a8064172c
commit 60df211b7a
No known key found for this signature in database
2 changed files with 6 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
content/client-server-api/_index.md
View file

@ -429,7 +429,7 @@ Instead, they can be reached via HTTPS on the [server name](/appendices/#server-
Servers hosting the `.well-known` JSON file SHOULD offer CORS headers, Servers hosting the `.well-known` JSON file SHOULD offer CORS headers,
as per the [CORS](#web-browser-clients) section in this specification. as per the [CORS](#web-browser-clients) section in this specification.
Servers SHOULD also ensure that each 30x redirect, if any, offers such CORS headers. {{% added-in v="1.19" %}} Servers SHOULD also ensure that each 30x redirect, if any, offers such CORS headers.
{{% /boxes/note %}} {{% /boxes/note %}}
The flow for auto-discovery is as follows: The flow for auto-discovery is as follows:
@ -437,8 +437,8 @@ The flow for auto-discovery is as follows:
1. Extract the [server name](/appendices/#server-name) from the user's Matrix ID by splitting the 1. Extract the [server name](/appendices/#server-name) from the user's Matrix ID by splitting the
Matrix ID at the first colon. Matrix ID at the first colon.
2. Extract the hostname from the server name as described by the [grammar](/appendices/#server-name). 2. Extract the hostname from the server name as described by the [grammar](/appendices/#server-name).
3. Make a GET request to `https://hostname/.well-known/matrix/client`. 30x redirects should be followed, 3. Make a GET request to `https://hostname/.well-known/matrix/client`.
however redirection loops should be avoided. {{% added-in v="1.19" %}} 30x redirects should be followed, however redirection loops should be avoided.
1. If the returned status code is 404, then `IGNORE`. 1. If the returned status code is 404, then `IGNORE`.
2. If the returned status code is not 200, or the response body is 2. If the returned status code is not 200, or the response body is
empty, then `FAIL_PROMPT`. empty, then `FAIL_PROMPT`.

6
data/api/client-server/wellknown.yaml
View file

@ -21,9 +21,9 @@ paths:
get: get:
summary: Gets Matrix server discovery information about the domain. summary: Gets Matrix server discovery information about the domain.
description: |- description: |-
Gets discovery information about the domain. Clients should follow 30x Gets discovery information about the domain.
redirects, carefully avoiding redirect loops, and use normal X.509 {{% added-in v="1.19" %}} Clients should follow 30x redirects, carefully
certificate validation. avoiding redirect loops, and use normal X.509 certificate validation.
The file may include The file may include
additional keys, which MUST follow the Java package naming convention, additional keys, which MUST follow the Java package naming convention,