Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-04-29 05:44:10 +02:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

C2S: Intro the upload/download endpoints differently

Browse source
This commit is contained in:
Travis Ralston 2024-06-10 15:45:17 -06:00
parent 214e38ae40
commit b19e73add5
1 changed files with 4 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -22,17 +22,15 @@ 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 media upload endpoints
/_matrix/media/v3/upload`](#post_matrixmediav3upload) and [`PUT in the [Content Repository module](#content-repository),
/_matrix/media/v3/upload/{serverName}/{mediaId}`](#put_matrixmediav3uploadservernamemediaid),
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.
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 the media download endpoints in the
[`GET /_matrix/media/v3/download/{serverName}/{mediaId}`](#get_matrixmediav3downloadservernamemediaid) [Content Repository module](#content-repository).
and [`GET /_matrix/media/v3/thumbnail/{serverName}/{mediaId}`](#get_matrixmediav3thumbnailservernamemediaid).
Servers must include a `Content-Type` header of `application/json` for all JSON responses. Servers must include a `Content-Type` header of `application/json` for all JSON responses.
All JSON data, in requests or responses, must be encoded using UTF-8. All JSON data, in requests or responses, must be encoded using UTF-8.