Reword the appservice portion of /account/whoami

Credit goes to richvdh - suggestions taken with edits.

Signed-off-by: Travis Ralston <travpc@gmail.com>
pull/977/head
Travis Ralston 7 years ago
parent 6ba5d7ca92
commit b7f8f20de9

@ -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…
Cancel
Save