wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Update client-server API endpoints to move from r0 to v3 (plus whitespace fixes) (#3421)

Browse source 
* Blind find & replace all on client major version -> v3

* Fix up bad replacements

* Fix anchors for r0->v3

* Changelog
This commit is contained in:
Travis Ralston 2021-10-12 11:07:01 -06:00 • committed by GitHub
parent 2d98cd3084
commit 95d850c418
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
69 changed files with 206 additions and 210 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/3421.feature Normal file
View file

@ -0,0 +1 @@
Re-version all endpoints to be `v3` as a starting point instead of `r0` as per [MSC2844](https://github.com/matrix-org/matrix-doc/pull/2844).

4
content/application-service-api.md
View file

@ -295,7 +295,7 @@ by the `sender_localpart` property of the registration.
An example request would be: An example request would be:
GET /_matrix/client/%CLIENT_MAJOR_VERSION%/account/whoami?user_id=@_irc_user:example.org GET /_matrix/client/v3/account/whoami?user_id=@_irc_user:example.org
Authorization: Bearer YourApplicationServiceTokenHere Authorization: Bearer YourApplicationServiceTokenHere
#### Timestamp massaging #### Timestamp massaging
@ -325,7 +325,7 @@ achieved by including the `as_token` on a `/register` request, along
with a login type of `m.login.application_service` to set the desired with a login type of `m.login.application_service` to set the desired
user ID without a password. user ID without a password.
POST /_matrix/client/%CLIENT_MAJOR_VERSION%/register POST /_matrix/client/v3/register
Authorization: Bearer YourApplicationServiceTokenHere Authorization: Bearer YourApplicationServiceTokenHere
Content: Content:

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

@ -799,7 +799,7 @@ type, it can direct the user to a web browser with the URL of a fallback
page which will allow the user to complete that login step out-of-band page which will allow the user to complete that login step out-of-band
in their web browser. The URL it should open is: in their web browser. The URL it should open is:
/_matrix/client/%CLIENT_MAJOR_VERSION%/auth/<auth type>/fallback/web?session=<session ID> /_matrix/client/v3/auth/<auth type>/fallback/web?session=<session ID>
Where `auth type` is the type name of the stage it is attempting and Where `auth type` is the type name of the stage it is attempting and
`session ID` is the ID of the session given by the homeserver. `session ID` is the ID of the session given by the homeserver.
@ -843,7 +843,7 @@ window which will handle unknown login types:
* homeserverUrl: the base url of the homeserver (e.g. "https://matrix.org") * homeserverUrl: the base url of the homeserver (e.g. "https://matrix.org")
* *
* apiEndpoint: the API endpoint being used (e.g. * apiEndpoint: the API endpoint being used (e.g.
* "/_matrix/client/%CLIENT_MAJOR_VERSION%/account/password") * "/_matrix/client/v3/account/password")
* *
* loginType: the loginType being attempted (e.g. "m.login.recaptcha") * loginType: the loginType being attempted (e.g. "m.login.recaptcha")
* *
@ -879,7 +879,7 @@ function unknownLoginType(homeserverUrl, apiEndpoint, loginType, sessionID, onCo
window.addEventListener("message", eventListener); window.addEventListener("message", eventListener);
var url = homeserverUrl + var url = homeserverUrl +
"/_matrix/client/%CLIENT_MAJOR_VERSION%/auth/" + "/_matrix/client/v3/auth/" +
encodeURIComponent(loginType) + encodeURIComponent(loginType) +
"/fallback/web?session=" + "/fallback/web?session=" +
encodeURIComponent(sessionID); encodeURIComponent(sessionID);
@ -1142,7 +1142,7 @@ Some examples of what should **not** be a capability are:
- Whether the server supports a feature in the `unstable` - Whether the server supports a feature in the `unstable`
specification. specification.
- Media size limits - these are handled by the - Media size limits - these are handled by the
`/media/%CLIENT_MAJOR_VERSION%/config` API. [`/config`](#get_matrixmediav3config) API.
- Optional encodings or alternative transports for communicating with - Optional encodings or alternative transports for communicating with
the server. the server.
@ -1271,9 +1271,9 @@ The expected pattern for using lazy-loading is currently:
The current endpoints which support lazy-loading room members are: The current endpoints which support lazy-loading room members are:
- [`/sync`](/client-server-api/#get_matrixclientr0sync) - [`/sync`](/client-server-api/#get_matrixclientv3sync)
- [`/rooms/<room_id>/messages`](/client-server-api/#get_matrixclientr0roomsroomidmessages) - [`/rooms/<room_id>/messages`](/client-server-api/#get_matrixclientv3roomsroomidmessages)
- [`/rooms/{roomId}/context/{eventId}`](/client-server-api/#get_matrixclientr0roomsroomidcontexteventid) - [`/rooms/{roomId}/context/{eventId}`](/client-server-api/#get_matrixclientv3roomsroomidcontexteventid)
### API endpoints ### API endpoints
@ -1419,13 +1419,13 @@ events.
### Syncing ### Syncing
To read events, the intended flow of operation is for clients to first To read events, the intended flow of operation is for clients to first
call the [`/sync`](/client-server-api/#get_matrixclientr0sync) API without a `since` parameter. This returns the call the [`/sync`](/client-server-api/#get_matrixclientv3sync) API without a `since` parameter. This returns the
most recent message events for each room, as well as the state of the most recent message events for each room, as well as the state of the
room at the start of the returned timeline. The response also includes a room at the start of the returned timeline. The response also includes a
`next_batch` field, which should be used as the value of the `since` `next_batch` field, which should be used as the value of the `since`
parameter in the next call to `/sync`. Finally, the response includes, parameter in the next call to `/sync`. Finally, the response includes,
for each room, a `prev_batch` field, which can be passed as a `start` for each room, a `prev_batch` field, which can be passed as a `start`
parameter to the [`/rooms/<room_id>/messages`](/client-server-api/#get_matrixclientr0roomsroomidmessages) API to retrieve earlier parameter to the [`/rooms/<room_id>/messages`](/client-server-api/#get_matrixclientv3roomsroomidmessages) API to retrieve earlier
messages. messages.
You can visualise the range of events being returned as: You can visualise the range of events being returned as:
@ -1462,7 +1462,7 @@ containing only the most recent message events. A state "delta" is also
returned, summarising any state changes in the omitted part of the returned, summarising any state changes in the omitted part of the
timeline. The client may therefore end up with "gaps" in its knowledge timeline. The client may therefore end up with "gaps" in its knowledge
of the message timeline. The client can fill these gaps using the of the message timeline. The client can fill these gaps using the
[`/rooms/<room_id>/messages`](/client-server-api/#get_matrixclientr0roomsroomidmessages) API. This situation looks like this: [`/rooms/<room_id>/messages`](/client-server-api/#get_matrixclientv3roomsroomidmessages) API. This situation looks like this:
``` ```
| gap | | gap |
@ -1786,7 +1786,7 @@ must have been invited to or have joined the room before they are
eligible to leave the room. Leaving a room to which the user has been eligible to leave the room. Leaving a room to which the user has been
invited rejects the invite, and can retract a knock. Once a user leaves invited rejects the invite, and can retract a knock. Once a user leaves
a room, it will no longer appear in the response to the a room, it will no longer appear in the response to the
[`/sync`](/client-server-api/#get_matrixclientr0sync) API unless it is [`/sync`](/client-server-api/#get_matrixclientv3sync) API unless it is
explicitly requested via a filter with the `include_leave` field set explicitly requested via a filter with the `include_leave` field set
to `true`. to `true`.
@ -1795,7 +1795,7 @@ Whether or not they actually joined the room, if the room is an
re-join the room. re-join the room.
A user can also forget a room which they have left. Rooms which have A user can also forget a room which they have left. Rooms which have
been forgotten will never appear the response to the [`/sync`](/client-server-api/#get_matrixclientr0sync) API, been forgotten will never appear the response to the [`/sync`](/client-server-api/#get_matrixclientv3sync) API,
until the user re-joins, is re-invited, or knocks. until the user re-joins, is re-invited, or knocks.
A user may wish to force another user to leave a room. This can be done A user may wish to force another user to leave a room. This can be done
@ -1816,7 +1816,7 @@ target user to leave the room and prevents them from re-joining the
room. A banned user will not be treated as a joined user, and so will room. A banned user will not be treated as a joined user, and so will
not be able to send or receive events in the room. In order to ban not be able to send or receive events in the room. In order to ban
someone, the user performing the ban MUST have the required power level. someone, the user performing the ban MUST have the required power level.
To ban a user, a request should be made to [`/rooms/<room_id>/ban`](/client-server-api/#post_matrixclientr0roomsroomidban) To ban a user, a request should be made to [`/rooms/<room_id>/ban`](/client-server-api/#post_matrixclientv3roomsroomidban)
with: with:
```json ```json
@ -1838,7 +1838,7 @@ target member's state, by making a request to
``` ```
A user must be explicitly unbanned with a request to A user must be explicitly unbanned with a request to
[`/rooms/<room_id>/unban`](/client-server-api/#post_matrixclientr0roomsroomidunban) before they can re-join the room or be [`/rooms/<room_id>/unban`](/client-server-api/#post_matrixclientv3roomsroomidunban) before they can re-join the room or be
re-invited. re-invited.
{{% http-api spec="client-server" api="banning" %}} {{% http-api spec="client-server" api="banning" %}}

8
content/client-server-api/modules/dm.md
View file

@ -24,7 +24,7 @@ whether a chat is 'direct' to an invitee.
#### Client behaviour #### Client behaviour
To start a direct chat with another user, the inviting user's client To start a direct chat with another user, the inviting user's client
should set the `is_direct` flag to [`/createRoom`](/client-server-api/#post_matrixclientr0createroom). The client should do this should set the `is_direct` flag to [`/createRoom`](/client-server-api/#post_matrixclientv3createroom). The client should do this
whenever the flow the user has followed is one where their intention is whenever the flow the user has followed is one where their intention is
to speak directly with another person, as opposed to bringing that to speak directly with another person, as opposed to bringing that
person in to a shared room. For example, clicking on 'Start Chat' beside person in to a shared room. For example, clicking on 'Start Chat' beside
@ -38,10 +38,10 @@ the flag altogether.
Both the inviting client and the invitee's client should record the fact Both the inviting client and the invitee's client should record the fact
that the room is a direct chat by storing an `m.direct` event in the that the room is a direct chat by storing an `m.direct` event in the
account data using [`/user/<user_id>/account_data/<type>`](/client-server-api/#put_matrixclientr0useruseridaccount_datatype). account data using [`/user/<user_id>/account_data/<type>`](/client-server-api/#put_matrixclientv3useruseridaccount_datatype).
#### Server behaviour #### Server behaviour
When the `is_direct` flag is given to [`/createRoom`](/client-server-api/#post_matrixclientr0createroom), the home server must set the When the `is_direct` flag is given to [`/createRoom`](/client-server-api/#post_matrixclientv3createroom), the home server must set the
`is_direct` flag in the invite member event for any users invited in the `is_direct` flag in the invite member event for any users invited in the
[`/createRoom`](/client-server-api/#post_matrixclientr0createroom) call. [`/createRoom`](/client-server-api/#post_matrixclientv3createroom) call.

48
content/client-server-api/modules/end_to_end_encryption.md
View file

@ -113,13 +113,13 @@ key, and a number of signed Curve25519 one-time keys.
##### Uploading keys ##### Uploading keys
A device uploads the public parts of identity keys to their homeserver A device uploads the public parts of identity keys to their homeserver
as a signed JSON object, using the [`/keys/upload`](/client-server-api/#post_matrixclientr0keysupload) API. The JSON object as a signed JSON object, using the [`/keys/upload`](/client-server-api/#post_matrixclientv3keysupload) API. The JSON object
must include the public part of the device's Ed25519 key, and must be must include the public part of the device's Ed25519 key, and must be
signed by that key, as described in [Signing signed by that key, as described in [Signing
JSON](/appendices/#signing-json). JSON](/appendices/#signing-json).
One-time keys are also uploaded to the homeserver using the One-time keys are also uploaded to the homeserver using the
[`/keys/upload`](/client-server-api/#post_matrixclientr0keysupload) API. [`/keys/upload`](/client-server-api/#post_matrixclientv3keysupload) API.
Devices must store the private part of each key they upload. They can Devices must store the private part of each key they upload. They can
discard the private part of a one-time key when they receive a message discard the private part of a one-time key when they receive a message
@ -134,12 +134,12 @@ too many private keys may discard keys starting with the oldest.
Before Alice can send an encrypted message to Bob, she needs a list of Before Alice can send an encrypted message to Bob, she needs a list of
each of his devices and the associated identity keys, so that she can each of his devices and the associated identity keys, so that she can
establish an encryption session with each device. This list can be establish an encryption session with each device. This list can be
obtained by calling [`/keys/query`](/client-server-api/#post_matrixclientr0keysquery), passing Bob's user ID in the obtained by calling [`/keys/query`](/client-server-api/#post_matrixclientv3keysquery), passing Bob's user ID in the
`device_keys` parameter. `device_keys` parameter.
From time to time, Bob may add new devices, and Alice will need to know From time to time, Bob may add new devices, and Alice will need to know
this so that she can include his new devices for later encrypted this so that she can include his new devices for later encrypted
messages. A naive solution to this would be to call [`/keys/query`](/client-server-api/#post_matrixclientr0keysquery) messages. A naive solution to this would be to call [`/keys/query`](/client-server-api/#post_matrixclientv3keysquery)
before sending each message -however, the number of users and devices before sending each message -however, the number of users and devices
may be large and this would be inefficient. may be large and this would be inefficient.
@ -157,23 +157,23 @@ process:
list, and a separate flag to indicate that its list of Bob's devices list, and a separate flag to indicate that its list of Bob's devices
is outdated. Both flags should be in storage which persists over is outdated. Both flags should be in storage which persists over
client restarts. client restarts.
2. It then makes a request to [`/keys/query`](/client-server-api/#post_matrixclientr0keysquery), passing Bob's user ID in 2. It then makes a request to [`/keys/query`](/client-server-api/#post_matrixclientv3keysquery), passing Bob's user ID in
the `device_keys` parameter. When the request completes, it stores the `device_keys` parameter. When the request completes, it stores
the resulting list of devices in persistent storage, and clears the the resulting list of devices in persistent storage, and clears the
'outdated' flag. 'outdated' flag.
3. During its normal processing of responses to [`/sync`](/client-server-api/#get_matrixclientr0sync), Alice's client 3. During its normal processing of responses to [`/sync`](/client-server-api/#get_matrixclientv3sync), Alice's client
inspects the `changed` property of the [`device_lists`](/client-server-api/#extensions-to-sync-1) field. If it inspects the `changed` property of the [`device_lists`](/client-server-api/#extensions-to-sync-1) field. If it
is tracking the device lists of any of the listed users, then it is tracking the device lists of any of the listed users, then it
marks the device lists for those users outdated, and initiates marks the device lists for those users outdated, and initiates
another request to [`/keys/query`](/client-server-api/#post_matrixclientr0keysquery) for them. another request to [`/keys/query`](/client-server-api/#post_matrixclientv3keysquery) for them.
4. Periodically, Alice's client stores the `next_batch` field of the 4. Periodically, Alice's client stores the `next_batch` field of the
result from [`/sync`](/client-server-api/#get_matrixclientr0sync) in persistent storage. If Alice later restarts her result from [`/sync`](/client-server-api/#get_matrixclientv3sync) in persistent storage. If Alice later restarts her
client, it can obtain a list of the users who have updated their client, it can obtain a list of the users who have updated their
device list while it was offline by calling [`/keys/changes`](/client-server-api/#get_matrixclientr0keyschanges), device list while it was offline by calling [`/keys/changes`](/client-server-api/#get_matrixclientv3keyschanges),
passing the recorded `next_batch` field as the `from` parameter. If passing the recorded `next_batch` field as the `from` parameter. If
the client is tracking the device list of any of the users listed in the client is tracking the device list of any of the users listed in
the response, it marks them as outdated. It combines this list with the response, it marks them as outdated. It combines this list with
those already flagged as outdated, and initiates a [`/keys/query`](/client-server-api/#post_matrixclientr0keysquery) those already flagged as outdated, and initiates a [`/keys/query`](/client-server-api/#post_matrixclientv3keysquery)
request for all of them. request for all of them.
{{% boxes/warning %}} {{% boxes/warning %}}
@ -339,7 +339,7 @@ Example:
A client wanting to set up a session with another device can claim a A client wanting to set up a session with another device can claim a
one-time key for that device. This is done by making a request to the one-time key for that device. This is done by making a request to the
[`/keys/claim`](/client-server-api/#post_matrixclientr0keysclaim) API. [`/keys/claim`](/client-server-api/#post_matrixclientv3keysclaim) API.
A homeserver should rate-limit the number of one-time keys that a given A homeserver should rate-limit the number of one-time keys that a given
user or remote server can claim. A homeserver should discard the public user or remote server can claim. A homeserver should discard the public
@ -860,11 +860,11 @@ key, then Alice's device can trust Bob's master key, and she can sign it
with her user-signing key. with her user-signing key.
Users upload their cross-signing keys to the server using [POST Users upload their cross-signing keys to the server using [POST
/\_matrix/client/r0/keys/device\_signing/upload](/client-server-api/#post_matrixclientr0keysdevice_signingupload). When Alice uploads /\_matrix/client/r0/keys/device\_signing/upload](/client-server-api/#post_matrixclientv3keysdevice_signingupload). When Alice uploads
new cross-signing keys, her user ID will appear in the `changed` new cross-signing keys, her user ID will appear in the `changed`
property of the `device_lists` field of the `/sync` of response of all property of the `device_lists` field of the `/sync` of response of all
users who share an encrypted room with her. When Bob sees Alice's user users who share an encrypted room with her. When Bob sees Alice's user
ID in his `/sync`, he will call [POST /\_matrix/client/r0/keys/query](/client-server-api/#post_matrixclientr0keysquery) ID in his `/sync`, he will call [POST /\_matrix/client/r0/keys/query](/client-server-api/#post_matrixclientv3keysquery)
to retrieve Alice's device and cross-signing keys. to retrieve Alice's device and cross-signing keys.
If Alice has a device and wishes to send an encrypted message to Bob, If Alice has a device and wishes to send an encrypted message to Bob,
@ -1166,17 +1166,17 @@ However, as the session keys are stored on the server encrypted, it
requires users to enter a decryption key to decrypt the session keys. requires users to enter a decryption key to decrypt the session keys.
To create a backup, a client will call [POST To create a backup, a client will call [POST
/\_matrix/client/r0/room\_keys/version](#post_matrixclientr0room_keysversion) and define how the keys are to /\_matrix/client/r0/room\_keys/version](#post_matrixclientv3room_keysversion) and define how the keys are to
be encrypted through the backup's `auth_data`; other clients can be encrypted through the backup's `auth_data`; other clients can
discover the backup by calling [GET discover the backup by calling [GET
/\_matrix/client/r0/room\_keys/version](#get_matrixclientr0room_keysversion). Keys are encrypted according /\_matrix/client/r0/room\_keys/version](#get_matrixclientv3room_keysversion). Keys are encrypted according
to the backup's `auth_data` and added to the backup by calling [PUT to the backup's `auth_data` and added to the backup by calling [PUT
/\_matrix/client/r0/room\_keys/keys](#put_matrixclientr0room_keyskeys) or one of its variants, and can /\_matrix/client/r0/room\_keys/keys](#put_matrixclientv3room_keyskeys) or one of its variants, and can
be retrieved by calling [GET /\_matrix/client/r0/room\_keys/keys](#get_matrixclientr0room_keyskeys) or be retrieved by calling [GET /\_matrix/client/r0/room\_keys/keys](#get_matrixclientv3room_keyskeys) or
one of its variants. Keys can only be written to the most recently one of its variants. Keys can only be written to the most recently
created version of the backup. Backups can also be deleted using [DELETE created version of the backup. Backups can also be deleted using [DELETE
/\_matrix/client/r0/room\_keys/version/{version}](#delete_matrixclientr0room_keysversionversion), or individual keys /\_matrix/client/r0/room\_keys/version/{version}](#delete_matrixclientv3room_keysversionversion), or individual keys
can be deleted using [DELETE /\_matrix/client/r0/room\_keys/keys](#delete_matrixclientr0room_keyskeys) or can be deleted using [DELETE /\_matrix/client/r0/room\_keys/keys](#delete_matrixclientv3room_keyskeys) or
one of its variants. one of its variants.
Clients must only store keys in backups after they have ensured that the Clients must only store keys in backups after they have ensured that the
@ -1458,7 +1458,7 @@ correspond to the user who sent the event, `recipient` to the local
user, and `recipient_keys` to the local ed25519 key. user, and `recipient_keys` to the local ed25519 key.
Clients must confirm that the `sender_key` and the `ed25519` field value Clients must confirm that the `sender_key` and the `ed25519` field value
under the `keys` property match the keys returned by [`/keys/query`](/client-server-api/#post_matrixclientr0keysquery) for under the `keys` property match the keys returned by [`/keys/query`](/client-server-api/#post_matrixclientv3keysquery) for
the given user, and must also verify the signature of the payload. the given user, and must also verify the signature of the payload.
Without this check, a client cannot be sure that the sender device owns Without this check, a client cannot be sure that the sender device owns
the private part of the ed25519 key it claims to have in the Olm the private part of the ed25519 key it claims to have in the Olm
@ -1590,17 +1590,17 @@ messages.
##### Extensions to /sync ##### Extensions to /sync
This module adds an optional `device_lists` property to the [`/sync`](/client-server-api/#get_matrixclientr0sync) response, This module adds an optional `device_lists` property to the [`/sync`](/client-server-api/#get_matrixclientv3sync) response,
as specified below. The server need only populate this property for an as specified below. The server need only populate this property for an
incremental `/sync` (i.e., one where the `since` parameter was incremental `/sync` (i.e., one where the `since` parameter was
specified). The client is expected to use [`/keys/query`](/client-server-api/#post_matrixclientr0keysquery) or specified). The client is expected to use [`/keys/query`](/client-server-api/#post_matrixclientv3keysquery) or
[`/keys/changes`](/client-server-api/#get_matrixclientr0keyschanges) for the equivalent functionality after an initial [`/keys/changes`](/client-server-api/#get_matrixclientv3keyschanges) for the equivalent functionality after an initial
sync, as documented in [Tracking the device list for a sync, as documented in [Tracking the device list for a
user](#tracking-the-device-list-for-a-user). user](#tracking-the-device-list-for-a-user).
It also adds a `one_time_keys_count` property. Note the spelling It also adds a `one_time_keys_count` property. Note the spelling
difference with the `one_time_key_counts` property in the difference with the `one_time_key_counts` property in the
[`/keys/upload`](/client-server-api/#post_matrixclientr0keysupload) response. [`/keys/upload`](/client-server-api/#post_matrixclientv3keysupload) response.
| Parameter | Type | Description | | Parameter | Type | Description |
|----------------------------|--------------------|------------------------------------------------------------------------------------------------------------------------| |----------------------------|--------------------|------------------------------------------------------------------------------------------------------------------------|

42
content/client-server-api/modules/guest_access.md
View file

@ -12,7 +12,7 @@ should interact with servers in order to participate in rooms as guests.
Guest users retrieve access tokens from a homeserver using the ordinary Guest users retrieve access tokens from a homeserver using the ordinary
[register [register
endpoint](#post_matrixclientr0register), endpoint](#post_matrixclientv3register),
specifying the `kind` parameter as `guest`. They may then interact with specifying the `kind` parameter as `guest`. They may then interact with
the client-server API as any other user would, but will only have access the client-server API as any other user would, but will only have access
to a subset of the API as described the Client behaviour subsection to a subset of the API as described the Client behaviour subsection
@ -39,38 +39,38 @@ rather than allowing all homeservers to enforce the rules on each other.
The following API endpoints are allowed to be accessed by guest accounts The following API endpoints are allowed to be accessed by guest accounts
for retrieving events: for retrieving events:
- [GET /rooms/:room\_id/state](#get_matrixclientr0roomsroomidstate) - [GET /rooms/:room\_id/state](#get_matrixclientv3roomsroomidstate)
- [GET /rooms/:room\_id/context/:event\_id](#get_matrixclientr0roomsroomidcontexteventid) - [GET /rooms/:room\_id/context/:event\_id](#get_matrixclientv3roomsroomidcontexteventid)
- [GET /rooms/:room\_id/event/:event\_id](#get_matrixclientr0roomsroomideventeventid) - [GET /rooms/:room\_id/event/:event\_id](#get_matrixclientv3roomsroomideventeventid)
- [GET /rooms/:room\_id/state/:event\_type/:state\_key](#get_matrixclientr0roomsroomidstateeventtypestatekey) - [GET /rooms/:room\_id/state/:event\_type/:state\_key](#get_matrixclientv3roomsroomidstateeventtypestatekey)
- [GET /rooms/:room\_id/messages](#get_matrixclientr0roomsroomidmessages) - [GET /rooms/:room\_id/messages](#get_matrixclientv3roomsroomidmessages)
- [GET /rooms/:room\_id/members](#get_matrixclientr0roomsroomidmembers) - [GET /rooms/:room\_id/members](#get_matrixclientv3roomsroomidmembers)
- [GET /rooms/:room\_id/initialSync](#get_matrixclientr0roomsroomidinitialsync) - [GET /rooms/:room\_id/initialSync](#get_matrixclientv3roomsroomidinitialsync)
- [GET /sync](#get_matrixclientr0sync) - [GET /sync](#get_matrixclientv3sync)
- [GET /events](#get_matrixclientr0events) as used for room previews. - [GET /events](#get_matrixclientv3events) as used for room previews.
The following API endpoints are allowed to be accessed by guest accounts The following API endpoints are allowed to be accessed by guest accounts
for sending events: for sending events:
- [POST /rooms/:room\_id/join](#post_matrixclientr0roomsroomidjoin) - [POST /rooms/:room\_id/join](#post_matrixclientv3roomsroomidjoin)
- [POST /rooms/:room\_id/leave](#post_matrixclientr0roomsroomidleave) - [POST /rooms/:room\_id/leave](#post_matrixclientv3roomsroomidleave)
- [PUT /rooms/:room\_id/send/m.room.message/:txn\_id](#put_matrixclientr0roomsroomidsendeventtypetxnid) - [PUT /rooms/:room\_id/send/m.room.message/:txn\_id](#put_matrixclientv3roomsroomidsendeventtypetxnid)
- [PUT /sendToDevice/{eventType}/{txnId}](#put_matrixclientr0sendtodeviceeventtypetxnid) - [PUT /sendToDevice/{eventType}/{txnId}](#put_matrixclientv3sendtodeviceeventtypetxnid)
The following API endpoints are allowed to be accessed by guest accounts The following API endpoints are allowed to be accessed by guest accounts
for their own account maintenance: for their own account maintenance:
- [PUT /profile/:user\_id/displayname](#put_matrixclientr0profileuseriddisplayname) - [PUT /profile/:user\_id/displayname](#put_matrixclientv3profileuseriddisplayname)
- [GET /devices](#get_matrixclientr0devices) - [GET /devices](#get_matrixclientv3devices)
- [GET /devices/{deviceId}](#get_matrixclientr0devicesdeviceid) - [GET /devices/{deviceId}](#get_matrixclientv3devicesdeviceid)
- [PUT /devices/{deviceId}](#put_matrixclientr0devicesdeviceid) - [PUT /devices/{deviceId}](#put_matrixclientv3devicesdeviceid)
The following API endpoints are allowed to be accessed by guest accounts The following API endpoints are allowed to be accessed by guest accounts
for end-to-end encryption: for end-to-end encryption:
- [POST /keys/upload](#post_matrixclientr0keysupload) - [POST /keys/upload](#post_matrixclientv3keysupload)
- [POST /keys/query](#post_matrixclientr0keysquery) - [POST /keys/query](#post_matrixclientv3keysquery)
- [POST /keys/claim](#post_matrixclientr0keysclaim) - [POST /keys/claim](#post_matrixclientv3keysclaim)
#### Server behaviour #### Server behaviour

2
content/client-server-api/modules/ignore_users.md
View file

@ -17,7 +17,7 @@ and servers can implement the ignoring of users.
To ignore a user, effectively blocking them, the client should add the To ignore a user, effectively blocking them, the client should add the
target user to the `m.ignored_user_list` event in their account data target user to the `m.ignored_user_list` event in their account data
using [`/user/<user_id>/account_data/<type>`](/client-server-api/#put_matrixclientr0useruseridaccount_datatype). Once ignored, the client will no longer receive events sent by using [`/user/<user_id>/account_data/<type>`](/client-server-api/#put_matrixclientv3useruseridaccount_datatype). Once ignored, the client will no longer receive events sent by
that user, with the exception of state events. The client should either that user, with the exception of state events. The client should either
hide previous content sent by the newly ignored user or perform a new hide previous content sent by the newly ignored user or perform a new
`/sync` with no previous token. `/sync` with no previous token.

10
content/client-server-api/modules/push.md
View file

@ -667,14 +667,14 @@ The content of the event is the current push rules for the user.
To create a rule that suppresses notifications for the room with ID To create a rule that suppresses notifications for the room with ID
`!dj234r78wl45Gh4D:matrix.org`: `!dj234r78wl45Gh4D:matrix.org`:
curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/%CLIENT_MAJOR_VERSION%/pushrules/global/room/%21dj234r78wl45Gh4D%3Amatrix.org?access_token=123456" -d \ curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/v3/pushrules/global/room/%21dj234r78wl45Gh4D%3Amatrix.org?access_token=123456" -d \
'{ '{
"actions" : ["dont_notify"] "actions" : ["dont_notify"]
}' }'
To suppress notifications for the user `@spambot:matrix.org`: To suppress notifications for the user `@spambot:matrix.org`:
curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/%CLIENT_MAJOR_VERSION%/pushrules/global/sender/%40spambot%3Amatrix.org?access_token=123456" -d \ curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/v3/pushrules/global/sender/%40spambot%3Amatrix.org?access_token=123456" -d \
'{ '{
"actions" : ["dont_notify"] "actions" : ["dont_notify"]
}' }'
@ -682,7 +682,7 @@ To suppress notifications for the user `@spambot:matrix.org`:
To always notify for messages that contain the work 'cake' and set a To always notify for messages that contain the work 'cake' and set a
specific sound (with a rule\_id of `SSByZWFsbHkgbGlrZSBjYWtl`): specific sound (with a rule\_id of `SSByZWFsbHkgbGlrZSBjYWtl`):
curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/%CLIENT_MAJOR_VERSION%/pushrules/global/content/SSByZWFsbHkgbGlrZSBjYWtl?access_token=123456" -d \ curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/v3/pushrules/global/content/SSByZWFsbHkgbGlrZSBjYWtl?access_token=123456" -d \
'{ '{
"pattern": "cake", "pattern": "cake",
"actions" : ["notify", {"set_sound":"cakealarm.wav"}] "actions" : ["notify", {"set_sound":"cakealarm.wav"}]
@ -691,7 +691,7 @@ specific sound (with a rule\_id of `SSByZWFsbHkgbGlrZSBjYWtl`):
To add a rule suppressing notifications for messages starting with To add a rule suppressing notifications for messages starting with
'cake' but ending with 'lie', superseding the previous rule: 'cake' but ending with 'lie', superseding the previous rule:
curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/%CLIENT_MAJOR_VERSION%/pushrules/global/content/U3BvbmdlIGNha2UgaXMgYmVzdA?access_token=123456&before=SSByZWFsbHkgbGlrZSBjYWtl" -d \ curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/v3/pushrules/global/content/U3BvbmdlIGNha2UgaXMgYmVzdA?access_token=123456&before=SSByZWFsbHkgbGlrZSBjYWtl" -d \
'{ '{
"pattern": "cake*lie", "pattern": "cake*lie",
"actions" : ["notify"] "actions" : ["notify"]
@ -701,7 +701,7 @@ To add a custom sound for notifications messages containing the word
'beer' in any rooms with 10 members or fewer (with greater importance 'beer' in any rooms with 10 members or fewer (with greater importance
than the room, sender and content rules): than the room, sender and content rules):
curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/%CLIENT_MAJOR_VERSION%/pushrules/global/override/U2VlIHlvdSBpbiBUaGUgRHVrZQ?access_token=123456" -d \ curl -X PUT -H "Content-Type: application/json" "https://example.com/_matrix/client/v3/pushrules/global/override/U2VlIHlvdSBpbiBUaGUgRHVrZQ?access_token=123456" -d \
'{ '{
"conditions": [ "conditions": [
{"kind": "event_match", "key": "content.body", "pattern": "beer" }, {"kind": "event_match", "key": "content.body", "pattern": "beer" },

10
content/client-server-api/modules/room_previews.md
View file

@ -11,18 +11,18 @@ This can be particularly effective when combined with [Guest Access](#guest-acce
Previews are implemented via the `world_readable` [Room History Previews are implemented via the `world_readable` [Room History
Visibility](#room-history-visibility). setting, along with a special version of the [GET Visibility](#room-history-visibility). setting, along with a special version of the [GET
/events](#get_matrixclientr0events) endpoint. /events](#get_matrixclientv3events) endpoint.
#### Client behaviour #### Client behaviour
A client wishing to view a room without joining it should call [GET A client wishing to view a room without joining it should call [GET
/rooms/:room\_id/initialSync](#get_matrixclientr0roomsroomidinitialsync), /rooms/:room\_id/initialSync](#get_matrixclientv3roomsroomidinitialsync),
followed by [GET /events](#get_matrixclientr0events). Clients will need to do followed by [GET /events](#get_matrixclientv3events). Clients will need to do
this in parallel for each room they wish to view. this in parallel for each room they wish to view.
Clients can of course also call other endpoints such as [GET Clients can of course also call other endpoints such as [GET
/rooms/:room\_id/messages](#get_matrixclientr0roomsroomidmessages) /rooms/:room\_id/messages](#get_matrixclientv3roomsroomidmessages)
and [GET /search](#post_matrixclientr0search) to and [GET /search](#post_matrixclientv3search) to
access events outside the `/events` stream. access events outside the `/events` stream.
{{% http-api spec="client-server" api="peeking_events" %}} {{% http-api spec="client-server" api="peeking_events" %}}

10
content/client-server-api/modules/send_to_device.md
View file

@ -13,19 +13,19 @@ client device.
The primary motivation for this API is exchanging data that is The primary motivation for this API is exchanging data that is
meaningless or undesirable to persist in the room DAG - for example, meaningless or undesirable to persist in the room DAG - for example,
one-time authentication tokens or key data. It is not intended for one-time authentication tokens or key data. It is not intended for
conversational data, which should be sent using the normal [`/rooms/<room_id>/send`](/client-server-api/#put_matrixclientr0roomsroomidsendeventtypetxnid) API for conversational data, which should be sent using the normal [`/rooms/<room_id>/send`](/client-server-api/#put_matrixclientv3roomsroomidsendeventtypetxnid) API for
consistency throughout Matrix. consistency throughout Matrix.
#### Client behaviour #### Client behaviour
To send a message to other devices, a client should call To send a message to other devices, a client should call
[`/sendToDevice`](/client-server-api/#put_matrixclientr0sendtodeviceeventtypetxnid). Only one message can be sent to each device per [`/sendToDevice`](/client-server-api/#put_matrixclientv3sendtodeviceeventtypetxnid). Only one message can be sent to each device per
transaction, and they must all have the same event type. The device ID transaction, and they must all have the same event type. The device ID
in the request body can be set to `*` to request that the message be in the request body can be set to `*` to request that the message be
sent to all known devices. sent to all known devices.
If there are send-to-device messages waiting for a client, they will be If there are send-to-device messages waiting for a client, they will be
returned by [`/sync`](/client-server-api/#get_matrixclientr0sync), as detailed in [Extensions to /sync](/client-server-api/#extensions-to-sync). Clients should returned by [`/sync`](/client-server-api/#get_matrixclientv3sync), as detailed in [Extensions to /sync](/client-server-api/#extensions-to-sync). Clients should
inspect the `type` of each returned event, and ignore any they do not inspect the `type` of each returned event, and ignore any they do not
understand. understand.
@ -33,7 +33,7 @@ understand.
Servers should store pending messages for local users until they are Servers should store pending messages for local users until they are
successfully delivered to the destination device. When a client calls successfully delivered to the destination device. When a client calls
[`/sync`](/client-server-api/#get_matrixclientr0sync) [`/sync`](/client-server-api/#get_matrixclientv3sync)
with an access token which corresponds to a device with pending with an access token which corresponds to a device with pending
messages, the server should list the pending messages, in order of messages, the server should list the pending messages, in order of
arrival, in the response body. arrival, in the response body.
@ -57,7 +57,7 @@ should be sent on to the remote servers via
##### Extensions to /sync ##### Extensions to /sync
This module adds the following properties to the [`/sync`](/client-server-api/#get_matrixclientr0sync) response: This module adds the following properties to the [`/sync`](/client-server-api/#get_matrixclientv3sync) response:
| Parameter | Type | Description | | Parameter | Type | Description |
|-----------|-----------|-----------------------------------------------------------------------------| |-----------|-----------|-----------------------------------------------------------------------------|

30
content/client-server-api/modules/sso_login.md
View file

@ -47,12 +47,12 @@ buttons. These are known as "identity providers" (IdPs).
An overview of the process is as follows: An overview of the process is as follows:
1. The Matrix client calls [`GET /login`](/client-server-api/#get_matrixclientr0login) to find the supported login 1. The Matrix client calls [`GET /login`](/client-server-api/#get_matrixclientv3login) to find the supported login
types, and the homeserver includes a flow with types, and the homeserver includes a flow with
`"type": "m.login.sso"` in the response. `"type": "m.login.sso"` in the response.
2. To initiate the `m.login.sso` login type, the Matrix client 2. To initiate the `m.login.sso` login type, the Matrix client
instructs the user's browser to navigate to the instructs the user's browser to navigate to the
[`/login/sso/redirect`](/client-server-api/#get_matrixclientr0loginssoredirect) endpoint on the user's homeserver. [`/login/sso/redirect`](/client-server-api/#get_matrixclientv3loginssoredirect) endpoint on the user's homeserver.
Note that this may be the IdP-dependent version of the endpoint if the Note that this may be the IdP-dependent version of the endpoint if the
user has selected one of the `identity_providers` from the flow. user has selected one of the `identity_providers` from the flow.
3. The homeserver responds with an HTTP redirect to the SSO user 3. The homeserver responds with an HTTP redirect to the SSO user
@ -63,7 +63,7 @@ An overview of the process is as follows:
5. The browser is directed to the `redirectUrl` provided by the client 5. The browser is directed to the `redirectUrl` provided by the client
with a `loginToken` query parameter for the client to log in with. with a `loginToken` query parameter for the client to log in with.
6. The client exchanges the login token for an access token by calling 6. The client exchanges the login token for an access token by calling
the [`/login`](/client-server-api/#post_matrixclientr0login) endpoint with a `type` of `m.login.token`. the [`/login`](/client-server-api/#post_matrixclientv3login) endpoint with a `type` of `m.login.token`.
For native applications, typically steps 1 to 4 are carried out by For native applications, typically steps 1 to 4 are carried out by
opening an embedded web view. opening an embedded web view.
@ -108,8 +108,8 @@ otherwise the same.
##### Client behaviour ##### Client behaviour
The client starts the process by instructing the browser to navigate to The client starts the process by instructing the browser to navigate to
[`/login/sso/redirect`](/client-server-api/#get_matrixclientr0loginssoredirect) [`/login/sso/redirect`](/client-server-api/#get_matrixclientv3loginssoredirect)
(or [`/login/sso/redirect/{idpId}`](/client-server-api/#get_matrixclientr0loginssoredirectidpid) (or [`/login/sso/redirect/{idpId}`](/client-server-api/#get_matrixclientv3loginssoredirectidpid)
when using one of the `identity_providers`) when using one of the `identity_providers`)
with an appropriate `redirectUrl`. Once with an appropriate `redirectUrl`. Once
authentication is successful, the browser will be redirected to that authentication is successful, the browser will be redirected to that
@ -159,7 +159,7 @@ the generic `/redirect` endpoint instead of the `/redirect/{idpId}` endpoint.
###### Redirecting to the Authentication server ###### Redirecting to the Authentication server
The server should handle The server should handle
`/_matrix/client/%CLIENT_MAJOR_VERSION%/login/sso/redirect` as follows: `/_matrix/client/v3/login/sso/redirect` as follows:
1. It should build a suitable request for the SSO system. 1. It should build a suitable request for the SSO system.
2. It should store enough state that the flow can be securely resumed 2. It should store enough state that the flow can be securely resumed
@ -193,11 +193,11 @@ The homeserver then proceeds as follows:
registered as a new user. registered as a new user.
3. The homeserver should generate a short-term login token. This is an 3. The homeserver should generate a short-term login token. This is an
opaque token, suitable for use with the `m.login.token` type of the opaque token, suitable for use with the `m.login.token` type of the
[`/login`](/client-server-api/#post_matrixclientr0login) API. The lifetime of this token SHOULD be limited to [`/login`](/client-server-api/#post_matrixclientv3login) API. The lifetime of this token SHOULD be limited to
around five seconds. around five seconds.
4. The homeserver adds a query parameter of `loginToken`, with the 4. The homeserver adds a query parameter of `loginToken`, with the
value of the generated login token, to the `redirectUrl` given in value of the generated login token, to the `redirectUrl` given in
the `/_matrix/client/%CLIENT_MAJOR_VERSION%/login/sso/redirect` the `/_matrix/client/v3/login/sso/redirect`
request. (Note: `redirectURL` may or may not include existing query request. (Note: `redirectURL` may or may not include existing query
parameters. If it already includes one or more `loginToken` parameters. If it already includes one or more `loginToken`
parameters, they should be removed before adding the new one.) parameters, they should be removed before adding the new one.)
@ -219,7 +219,7 @@ The homeserver then proceeds as follows:
are happy to grant access to their matrix account to the site named are happy to grant access to their matrix account to the site named
in the `redirectUrl`. This can be done either *before* redirecting in the `redirectUrl`. This can be done either *before* redirecting
to the SSO login page when handling the to the SSO login page when handling the
`/_matrix/client/%CLIENT_MAJOR_VERSION%/login/sso/redirect` `/_matrix/client/v3/login/sso/redirect`
endpoint, or *after* login when handling the callback from the endpoint, or *after* login when handling the callback from the
authentication server. (If the check is performed before authentication server. (If the check is performed before
redirecting, it is particularly important that the homeserver guards redirecting, it is particularly important that the homeserver guards
@ -232,7 +232,7 @@ The homeserver then proceeds as follows:
2. For added security, homeservers SHOULD guard against unsolicited 2. For added security, homeservers SHOULD guard against unsolicited
authentication attempts by tracking pending requests. One way to do authentication attempts by tracking pending requests. One way to do
this is to set a cookie when handling this is to set a cookie when handling
`/_matrix/client/%CLIENT_MAJOR_VERSION%/login/sso/redirect`, which `/_matrix/client/v3/login/sso/redirect`, which
is checked and cleared when handling the callback from the is checked and cleared when handling the callback from the
authentication server. authentication server.
@ -254,7 +254,7 @@ Clients do not need to take any particular additional steps beyond
ensuring that the fallback mechanism has been implemented, and treating ensuring that the fallback mechanism has been implemented, and treating
the `m.login.sso` authentication type the same as any other unknown type the `m.login.sso` authentication type the same as any other unknown type
(i.e. they should open a browser window for (i.e. they should open a browser window for
`/_matrix/client/%CLIENT_MAJOR_VERSION%/auth/m.login.sso/fallback/web?session=<session_id>`. `/_matrix/client/v3/auth/m.login.sso/fallback/web?session=<session_id>`.
Once the flow has completed, the client retries the request with the Once the flow has completed, the client retries the request with the
session only.) session only.)
@ -263,9 +263,9 @@ session only.)
##### Redirecting to the Authentication server ##### Redirecting to the Authentication server
The server should handle The server should handle
`/_matrix/client/%CLIENT_MAJOR_VERSION%/auth/m.login.sso/fallback/web` `/_matrix/client/v3/auth/m.login.sso/fallback/web`
in much the same way as in much the same way as
`/_matrix/client/%CLIENT_MAJOR_VERSION%/login/sso/redirect`, which is to `/_matrix/client/v3/login/sso/redirect`, which is to
say: say:
1. It should build a suitable request for the SSO system. 1. It should build a suitable request for the SSO system.
@ -312,7 +312,7 @@ fallback completion](#fallback) page to the user's browser.
This confirmation could take place before redirecting to the SSO This confirmation could take place before redirecting to the SSO
authentication page (when handling the authentication page (when handling the
`/_matrix/client/%CLIENT_MAJOR_VERSION%/auth/m.login.sso/fallback/web` `/_matrix/client/v3/auth/m.login.sso/fallback/web`
endpoint), or *after* authentication when handling the callback from endpoint), or *after* authentication when handling the callback from
the authentication server. (If the check is performed before the authentication server. (If the check is performed before
redirecting, it is particularly important that the homeserver guards redirecting, it is particularly important that the homeserver guards
@ -321,6 +321,6 @@ fallback completion](#fallback) page to the user's browser.
2. For added security, homeservers SHOULD guard against unsolicited 2. For added security, homeservers SHOULD guard against unsolicited
authentication attempts by tracking pending requests. One way to do authentication attempts by tracking pending requests. One way to do
this is to set a cookie when handling this is to set a cookie when handling
`/_matrix/client/%CLIENT_MAJOR_VERSION%/auth/m.login.sso/fallback/web`, `/_matrix/client/v3/auth/m.login.sso/fallback/web`,
which is checked and cleared when handling the callback from the which is checked and cleared when handling the callback from the
authentication server. authentication server.

2
data/api/client-server/account-data.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/admin.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

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

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -427,7 +427,7 @@ paths:
already associated with an account on this homeserver. This API should already associated with an account on this homeserver. This API should
be used to request validation tokens when adding an email address to an be used to request validation tokens when adding an email address to an
account. This API's parameters and response are identical to that of account. This API's parameters and response are identical to that of
the [`/register/email/requestToken`](/client-server-api/#post_matrixclientr0registeremailrequesttoken) the [`/register/email/requestToken`](/client-server-api/#post_matrixclientv3registeremailrequesttoken)
endpoint. The homeserver should validate endpoint. The homeserver should validate
the email itself, either by sending a validation email itself or by using the email itself, either by sending a validation email itself or by using
a service it has control over. a service it has control over.
@ -480,7 +480,7 @@ paths:
already associated with an account on this homeserver. This API should already associated with an account on this homeserver. This API should
be used to request validation tokens when adding a phone number to an be used to request validation tokens when adding a phone number to an
account. This API's parameters and response are identical to that of account. This API's parameters and response are identical to that of
the [`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientr0registermsisdnrequesttoken) the [`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientv3registermsisdnrequesttoken)
endpoint. The homeserver should validate endpoint. The homeserver should validate
the phone number itself, either by sending a validation message itself or by using the phone number itself, either by sending a validation message itself or by using
a service it has control over. a service it has control over.

2
data/api/client-server/appservice_room_directory.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/banning.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/capabilities.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
produces: produces:
- application/json - application/json
securityDefinitions: securityDefinitions:

2
data/api/client-server/content-repo.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/media/%CLIENT_MAJOR_VERSION% basePath: /_matrix/media/v3
consumes: consumes:
- application/json - application/json
- "*/*" - "*/*"

2
data/api/client-server/create_room.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/cross_signing.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/definitions/timeline_batch.yaml
View file

@ -21,7 +21,7 @@ properties:
type: boolean type: boolean
prev_batch: prev_batch:
description: A token that can be supplied to the `from` parameter of the description: A token that can be supplied to the `from` parameter of the
[`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages) [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
endpoint in order to retrieve earlier events. endpoint in order to retrieve earlier events.
If no earlier events are available, this property may be omitted from If no earlier events are available, this property may be omitted from

2
data/api/client-server/device_management.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/directory.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/event_context.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/filter.yaml
View file

@ -18,7 +18,7 @@ info:
host: localhost:8008 host: localhost:8008
schemes: schemes:
- https - https
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

4
data/api/client-server/inviting.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -36,7 +36,7 @@ paths:
*Note that there are two forms of this API, which are documented separately. *Note that there are two forms of this API, which are documented separately.
This version of the API requires that the inviter knows the Matrix This version of the API requires that the inviter knows the Matrix
identifier of the invitee. The other is documented in the* identifier of the invitee. The other is documented in the*
[third party invites section](/client-server-api/#post_matrixclientr0roomsroomidinvite-1). [third party invites section](/client-server-api/#post_matrixclientv3roomsroomidinvite-1).
This API invites a user to participate in a particular room. This API invites a user to participate in a particular room.
They do not start participating in the room until they actually join the They do not start participating in the room until they actually join the

10
data/api/client-server/joining.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -40,8 +40,8 @@ paths:
events associated with the room until the user leaves the room. events associated with the room until the user leaves the room.
After a user has joined a room, the room will appear as an entry in the After a user has joined a room, the room will appear as an entry in the
response of the [`/initialSync`](/client-server-api/#get_matrixclientr0initialsync) response of the [`/initialSync`](/client-server-api/#get_matrixclientv3initialsync)
and [`/sync`](/client-server-api/#get_matrixclientr0sync) APIs. and [`/sync`](/client-server-api/#get_matrixclientv3sync) APIs.
operationId: joinRoomById operationId: joinRoomById
security: security:
- accessToken: [] - accessToken: []
@ -117,8 +117,8 @@ paths:
events associated with the room until the user leaves the room. events associated with the room until the user leaves the room.
After a user has joined a room, the room will appear as an entry in the After a user has joined a room, the room will appear as an entry in the
response of the [`/initialSync`](/client-server-api/#get_matrixclientr0initialsync) response of the [`/initialSync`](/client-server-api/#get_matrixclientv3initialsync)
and [`/sync`](/client-server-api/#get_matrixclientr0sync) APIs. and [`/sync`](/client-server-api/#get_matrixclientv3sync) APIs.
operationId: joinRoom operationId: joinRoom
security: security:
- accessToken: [] - accessToken: []

12
data/api/client-server/key_backup.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -170,7 +170,7 @@ paths:
description: |- description: |-
The backup version to get, as returned in the `version` parameter The backup version to get, as returned in the `version` parameter
of the response in of the response in
[`POST /_matrix/client/r0/room_keys/version`](/client-server/#post_matrixclientr0room_keysversion) [`POST /_matrix/client/r0/room_keys/version`](/client-server/#post_matrixclientv3room_keysversion)
or this endpoint. or this endpoint.
required: true required: true
x-example: "1" x-example: "1"
@ -252,8 +252,8 @@ paths:
description: |- description: |-
The backup version to update, as returned in the `version` The backup version to update, as returned in the `version`
parameter in the response of parameter in the response of
[`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientr0room_keysversion) [`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientv3room_keysversion)
or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientr0room_keysversionversion). or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientv3room_keysversionversion).
required: true required: true
x-example: "1" x-example: "1"
- in: body - in: body
@ -341,8 +341,8 @@ paths:
description: |- description: |-
The backup version to delete, as returned in the `version` The backup version to delete, as returned in the `version`
parameter in the response of parameter in the response of
[`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientr0room_keysversion) [`POST /_matrix/client/r0/room_keys/version`](/client-server-api/#post_matrixclientv3room_keysversion)
or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientr0room_keysversionversion). or [`GET /_matrix/client/r0/room_keys/version/{version}`](/client-server-api/#get_matrixclientv3room_keysversionversion).
required: true required: true
x-example: "1" x-example: "1"
responses: responses:

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

@ -21,7 +21,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -437,7 +437,7 @@ paths:
type: string type: string
description: |- description: |-
The desired start point of the list. Should be the `next_batch` field The desired start point of the list. Should be the `next_batch` field
from a response to an earlier call to [`/sync`](/client-server-api/#get_matrixclientr0sync). Users who have not from a response to an earlier call to [`/sync`](/client-server-api/#get_matrixclientv3sync). Users who have not
uploaded new device identity keys since this point, nor deleted uploaded new device identity keys since this point, nor deleted
existing devices with identity keys since then, will be excluded existing devices with identity keys since then, will be excluded
from the results. from the results.
@ -448,7 +448,7 @@ paths:
type: string type: string
description: |- description: |-
The desired end point of the list. Should be the `next_batch` The desired end point of the list. Should be the `next_batch`
field from a recent call to [`/sync`](/client-server-api/#get_matrixclientr0sync) - typically the most recent field from a recent call to [`/sync`](/client-server-api/#get_matrixclientv3sync) - typically the most recent
such call. This may be used by the server as a hint to check its such call. This may be used by the server as a hint to check its
caches are up to date. caches are up to date.
required: true required: true

2
data/api/client-server/kicking.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

4
data/api/client-server/knocking.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -45,7 +45,7 @@ paths:
history visibility to the user. history visibility to the user.
The knock will appear as an entry in the response of the The knock will appear as an entry in the response of the
[`/sync`](/client-server-api/#get_matrixclientr0sync) API. [`/sync`](/client-server-api/#get_matrixclientv3sync) API.
operationId: knockRoom operationId: knockRoom
security: security:
- accessToken: [] - accessToken: []

2
data/api/client-server/leaving.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/list_joined_rooms.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/list_public_rooms.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/login.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/logout.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/message_pagination.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/notifications.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

14
data/api/client-server/old_sync.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -35,7 +35,7 @@ paths:
block until an event is received, or until the `timeout` is reached. block until an event is received, or until the `timeout` is reached.
This endpoint was deprecated in r0 of this specification. Clients This endpoint was deprecated in r0 of this specification. Clients
should instead call the [`/sync`](/client-server-api/#get_matrixclientr0sync) should instead call the [`/sync`](/client-server-api/#get_matrixclientv3sync)
endpoint with a `since` parameter. See endpoint with a `since` parameter. See
the [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints). the [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints).
operationId: getEvents operationId: getEvents
@ -101,7 +101,7 @@ paths:
number of messages per room to return. number of messages per room to return.
This endpoint was deprecated in r0 of this specification. Clients This endpoint was deprecated in r0 of this specification. Clients
should instead call the [`/sync`](/client-server-api/#get_matrixclientr0sync) should instead call the [`/sync`](/client-server-api/#get_matrixclientv3sync)
endpoint with no `since` parameter. See endpoint with no `since` parameter. See
the [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints). the [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints).
operationId: initialSync operationId: initialSync
@ -239,7 +239,7 @@ paths:
description: |- description: |-
A token which correlates to the start of `chunk`. A token which correlates to the start of `chunk`.
Can be passed to Can be passed to
[`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages) [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
to retrieve earlier events. to retrieve earlier events.
If no earlier events are available, this property may be omitted from If no earlier events are available, this property may be omitted from
@ -249,7 +249,7 @@ paths:
description: |- description: |-
A token which correlates to the end of `chunk`. A token which correlates to the end of `chunk`.
Can be passed to Can be passed to
[`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages) [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
to retrieve later events. to retrieve later events.
chunk: chunk:
type: array type: array
@ -318,8 +318,8 @@ paths:
This endpoint was deprecated in r0 of this specification. Clients This endpoint was deprecated in r0 of this specification. Clients
should instead call the should instead call the
[/rooms/{roomId}/event/{eventId}](/client-server-api/#get_matrixclientr0roomsroomideventeventid) API [/rooms/{roomId}/event/{eventId}](/client-server-api/#get_matrixclientv3roomsroomideventeventid) API
or the [/rooms/{roomId}/context/{eventId](/client-server-api/#get_matrixclientr0roomsroomidcontexteventid) API. or the [/rooms/{roomId}/context/{eventId](/client-server-api/#get_matrixclientv3roomsroomidcontexteventid) API.
operationId: getOneEvent operationId: getOneEvent
security: security:
- accessToken: [] - accessToken: []

2
data/api/client-server/openid.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/peeking_events.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/presence.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/profile.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/pusher.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/pushrules.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/read_markers.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/receipts.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/redaction.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

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

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -393,7 +393,7 @@ paths:
`/account/password` endpoint. `/account/password` endpoint.
This API's parameters and response are identical to that of the This API's parameters and response are identical to that of the
[`/register/email/requestToken`](/client-server-api/#post_matrixclientr0registeremailrequesttoken) [`/register/email/requestToken`](/client-server-api/#post_matrixclientv3registeremailrequesttoken)
endpoint, except that endpoint, except that
`M_THREEPID_NOT_FOUND` may be returned if no account matching the `M_THREEPID_NOT_FOUND` may be returned if no account matching the
given email address could be found. The server may instead send an given email address could be found. The server may instead send an
@ -450,7 +450,7 @@ paths:
`/account/password` endpoint. `/account/password` endpoint.
This API's parameters and response are identical to that of the This API's parameters and response are identical to that of the
[`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientr0registermsisdnrequesttoken) [`/register/msisdn/requestToken`](/client-server-api/#post_matrixclientv3registermsisdnrequesttoken)
endpoint, except that endpoint, except that
`M_THREEPID_NOT_FOUND` may be returned if no account matching the `M_THREEPID_NOT_FOUND` may be returned if no account matching the
given phone number could be found. The server may instead send the SMS given phone number could be found. The server may instead send the SMS

2
data/api/client-server/report_content.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

8
data/api/client-server/room_initial_sync.yaml
View file

@ -6,7 +6,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -22,7 +22,7 @@ paths:
This endpoint was deprecated in r0 of this specification. There is no This endpoint was deprecated in r0 of this specification. There is no
direct replacement; the relevant information is returned by the direct replacement; the relevant information is returned by the
[`/sync`](/client-server-api/#get_matrixclientr0sync) API. See the [`/sync`](/client-server-api/#get_matrixclientv3sync) API. See the
[migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints). [migration guide](https://matrix.org/docs/guides/migrating-from-client-server-api-v-1#deprecated-endpoints).
operationId: roomInitialSync operationId: roomInitialSync
security: security:
@ -99,7 +99,7 @@ paths:
type: string type: string
description: |- description: |-
A token which correlates to the start of `chunk`. Can be passed to A token which correlates to the start of `chunk`. Can be passed to
[`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages) [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
to retrieve earlier events. to retrieve earlier events.
If no earlier events are available, this property may be omitted from If no earlier events are available, this property may be omitted from
@ -108,7 +108,7 @@ paths:
type: string type: string
description: |- description: |-
A token which correlates to the end of `chunk`. Can be passed to A token which correlates to the end of `chunk`. Can be passed to
[`/rooms/<room_id>/messages`](#get_matrixclientr0roomsroomidmessages) [`/rooms/<room_id>/messages`](#get_matrixclientv3roomsroomidmessages)
to retrieve later events. to retrieve later events.
chunk: chunk:
type: array type: array

2
data/api/client-server/room_send.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/room_state.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/room_upgrades.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/rooms.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/search.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/sso_login_redirect.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
paths: paths:
"/login/sso/redirect": "/login/sso/redirect":
get: get:

2
data/api/client-server/sync.yaml
View file

@ -18,7 +18,7 @@ info:
host: localhost:8008 host: localhost:8008
schemes: schemes:
- https - https
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/tags.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/third_party_lookup.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

4
data/api/client-server/third_party_membership.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:
@ -36,7 +36,7 @@ paths:
identifier of the invitee, and instead relies on third party identifiers. identifier of the invitee, and instead relies on third party identifiers.
The homeserver uses an identity server to perform the mapping from The homeserver uses an identity server to perform the mapping from
third party identifier to a Matrix identifier. The other is documented in the* third party identifier to a Matrix identifier. The other is documented in the*
[joining rooms section](/client-server-api/#post_matrixclientr0roomsroomidinvite). [joining rooms section](/client-server-api/#post_matrixclientv3roomsroomidinvite).
This API invites a user to participate in a particular room. This API invites a user to participate in a particular room.
They do not start participating in the room until they actually join the They do not start participating in the room until they actually join the

2
data/api/client-server/to_device.yaml
View file

@ -20,7 +20,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/typing.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/users.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/voip.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
consumes: consumes:
- application/json - application/json
produces: produces:

2
data/api/client-server/whoami.yaml
View file

@ -19,7 +19,7 @@ host: localhost:8008
schemes: schemes:
- https - https
- http - http
basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% basePath: /_matrix/client/v3
produces: produces:
- application/json - application/json
securityDefinitions: securityDefinitions:

2
layouts/shortcodes/http-api.html
View file

@ -20,7 +20,7 @@
{{ $api := .Params.api}} {{ $api := .Params.api}}
{{ $api_data := index .Site.Data.api .Params.spec .Params.api }} {{ $api_data := index .Site.Data.api .Params.spec .Params.api }}
{{ $base_url := replace $api_data.basePath "%CLIENT_MAJOR_VERSION%" "r0" }} {{ $base_url := $api_data.basePath }}
{{ $path := delimit (slice "api" $spec) "/" }} {{ $path := delimit (slice "api" $spec) "/" }}
{{ partial "openapi/render-api" (dict "api_data" $api_data "base_url" $base_url "path" $path) }} {{ partial "openapi/render-api" (dict "api_data" $api_data "base_url" $base_url "path" $path) }}

4
openapi_extensions.md
View file

@ -9,9 +9,7 @@ parsers should be able to take advantage of the added syntax.
## Using multiple files to describe API ## Using multiple files to describe API
To ease API design and management, the API definition is split across several To ease API design and management, the API definition is split across several
files. Each of these files is self-contained valid OpenAPI (except files. Each of these files is self-contained valid OpenAPI.
client-server files that become valid OpenAPI after substituting
`%CLIENT_MAJOR_VERSION%` with `unstable` or an API release).
There is no single root file in the source tree as OpenAPI requires; this file There is no single root file in the source tree as OpenAPI requires; this file
can be generated by `dump_swagger.py` (also doing the substitution mentioned can be generated by `dump_swagger.py` (also doing the substitution mentioned

3
scripts/dump-swagger.py
View file

@ -107,8 +107,6 @@ for filename in os.listdir(cs_api_dir):
basePath = api['basePath'] basePath = api['basePath']
for path, methods in api["paths"].items(): for path, methods in api["paths"].items():
path = (basePath + path).replace('%CLIENT_MAJOR_VERSION%',
major_version)
for method, spec in methods.items(): for method, spec in methods.items():
if "tags" in spec.keys(): if "tags" in spec.keys():
if path not in output["paths"]: if path not in output["paths"]:
@ -126,5 +124,4 @@ except OSError as e:
with open(output_file, "w") as f: with open(output_file, "w") as f:
text = json.dumps(output, sort_keys=True, indent=4) text = json.dumps(output, sort_keys=True, indent=4)
text = text.replace("%CLIENT_RELEASE_LABEL%", release_label) text = text.replace("%CLIENT_RELEASE_LABEL%", release_label)
text = text.replace("%CLIENT_MAJOR_VERSION%", major_version)
f.write(text) f.write(text)