Reword the appservice portion of /account/whoami
Credit goes to richvdh - suggestions taken with edits. Signed-off-by: Travis Ralston <travpc@gmail.com>
This commit is contained in:
parent
6ba5d7ca92
commit
b7f8f20de9
1 changed files with 7 additions and 17 deletions
|
@ -31,26 +31,16 @@ paths:
|
||||||
description: |-
|
description: |-
|
||||||
Gets information about the owner of a given access token.
|
Gets information about the owner of a given access token.
|
||||||
|
|
||||||
If the owner of the access token is an application service,
|
Note that, as with the rest of the Client-Server API,
|
||||||
the server should return the user ID making the request. The
|
Application Services may masquerade as users within their
|
||||||
user ID making the request can be determined by checking to
|
namespace by giving a ``user_id`` query parameter. In this
|
||||||
see if the ``user_id`` query parameter was also supplied. If
|
situation, the server should verify that the given ``user_id``
|
||||||
the parameter is not present, the default application service
|
is registered by the appservice, and return it in the response
|
||||||
user ID should be used (defined as the ``sender_localpart``
|
body.
|
||||||
in the registration). If the parameter is present, the given
|
|
||||||
user ID should be verified to be both registered and in the
|
|
||||||
application service's namespace.
|
|
||||||
operationId: getTokenOwner
|
operationId: getTokenOwner
|
||||||
security:
|
security:
|
||||||
- accessToken: []
|
- accessToken: []
|
||||||
parameters:
|
parameters: []
|
||||||
# TODO: Break this out to a template or something (and apply it everywhere)
|
|
||||||
- in: query
|
|
||||||
name: user_id
|
|
||||||
type: string
|
|
||||||
required: false
|
|
||||||
description: |-
|
|
||||||
The user ID to masquerade as. Only applies to application services.
|
|
||||||
responses:
|
responses:
|
||||||
200:
|
200:
|
||||||
description:
|
description:
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue