|
|
|
@ -255,9 +255,29 @@ This information is returned in the `/api/v1/accounts/verify_credentials` endpoi
|
|
|
|
|
|
|
|
|
|
*Pleroma supports refreshing tokens.*
|
|
|
|
|
|
|
|
|
|
`POST /oauth/token`
|
|
|
|
|
### POST `/oauth/token`
|
|
|
|
|
|
|
|
|
|
Post here request with `grant_type=refresh_token` to obtain new access token. Returns an access token.
|
|
|
|
|
You can obtain access tokens for a user in a few additional ways.
|
|
|
|
|
|
|
|
|
|
#### Refreshing a token
|
|
|
|
|
|
|
|
|
|
To obtain a new access token from a refresh token, pass `grant_type=refresh_token` with the following extra parameters:
|
|
|
|
|
|
|
|
|
|
- `refresh_token`: The refresh token.
|
|
|
|
|
|
|
|
|
|
#### Getting a token with a password
|
|
|
|
|
|
|
|
|
|
To obtain a token from a user's password, pass `grant_type=password` with the following extra parameters:
|
|
|
|
|
|
|
|
|
|
- `username`: Username to authenticate.
|
|
|
|
|
- `password`: The user's password.
|
|
|
|
|
|
|
|
|
|
#### Response body
|
|
|
|
|
|
|
|
|
|
Additional fields are returned in the response:
|
|
|
|
|
|
|
|
|
|
- `id`: The primary key of this token in Pleroma's database.
|
|
|
|
|
- `me` (user tokens only): The ActivityPub ID of the user who owns the token.
|
|
|
|
|
|
|
|
|
|
## Account Registration
|
|
|
|
|
|
|
|
|
|