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

Spec exchanging refresh tokens for new access tokens

Browse source
This commit is contained in:
Daniel Wagner-Hall 2015-08-28 10:31:45 +01:00
parent 902c7d3ea6
commit 0440983c4a
1 changed files with 24 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
specification/10_client_server_api.rst
View file

@ -1087,10 +1087,33 @@ On success, this returns a JSON object with keys:
user_id
The fully-qualified Matrix ID that has been registered.
access_token
An access token for the new account.
An access token for the account. This token may expire at some point, and if
so, it MAY come with a refersh_token, described below.
refresh_token (optional)
A refresh token may be exchanged for a new access_token as described in
`Refreshing access tokens`.
home_server
The hostname of the Home Server on which the account has been registered.
Refreshing access tokens
~~~~~~~~~~~~~~~~~~~~~~~~
Exchanging a refresh token for an access token is done using the request::
POST $PREFIX/tokenrefresh
The body of the POST request is a JSON object containing:
refresh_token
The refresh token.
On success, this invalidates the refresh token, so that it cannot be used again,
and returns a JSON object with keys:
access_token
An access token for the account, as is returned from login.
refresh_token (optional)
A refresh token, as is returned from login.
Changing Password
~~~~~~~~~~~~~~~~~
This section refers to API Version 2. These API calls currently use the prefix