Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-03-25 12:34:10 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Reword exceptions list

Browse source
This commit is contained in:
Olivier 'reivilibre 2024-06-05 16:08:47 +01:00
parent a171b91e9c
commit b242d4b344
1 changed files with 10 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -22,14 +22,20 @@ recommended outside test environments.
Clients are authenticated using opaque `access_token` strings (see [Client Clients are authenticated using opaque `access_token` strings (see [Client
Authentication](#client-authentication) for details). Authentication](#client-authentication) for details).
All `POST` and `PUT` endpoints, with the exception of [`POST All `POST` and `PUT` endpoints, with the exception of those listed below,
/_matrix/media/v3/upload`](#post_matrixmediav3upload), [`PUT
/_matrix/media/v3/upload/{serverName}/{mediaId}`](#put_matrixmediav3uploadservernamemediaid)
and [`POST /_matrix/client/v3/logout`](#post_matrixclientv3logout),
require the client to supply a request body containing a (potentially empty) require the client to supply a request body containing a (potentially empty)
JSON object. Clients should supply a `Content-Type` header of JSON object. Clients should supply a `Content-Type` header of
`application/json` for all requests with JSON bodies, but this is not required. `application/json` for all requests with JSON bodies, but this is not required.
The exceptions are:
- [`POST /_matrix/media/v3/upload`](#post_matrixmediav3upload),
which takes any type of request body depending on what type of media is to be uploaded.
- [`PUT /_matrix/media/v3/upload/{serverName}/{mediaId}`](#put_matrixmediav3uploadservernamemediaid),
which takes any type of request body depending on what type of media is to be uploaded.
- [`POST /_matrix/client/v3/logout`](#post_matrixclientv3logout),
which does not take any request body.
Similarly, all endpoints require the server to return a JSON object, Similarly, all endpoints require the server to return a JSON object,
with the exception of 200 responses to with the exception of 200 responses to
[`GET /_matrix/media/v3/download/{serverName}/{mediaId}`](#get_matrixmediav3downloadservernamemediaid) [`GET /_matrix/media/v3/download/{serverName}/{mediaId}`](#get_matrixmediav3downloadservernamemediaid)