api: Improve docs for AuthScheme variants

This commit is contained in:
Jonas Platte 2020-12-13 12:19:54 +01:00
parent e1d621ebd0
commit b38ae1bb76
No known key found for this signature in database
GPG Key ID: CC154DE0E30B7C67

View File

@ -280,14 +280,17 @@ pub enum AuthScheme {
/// No authentication is performed.
None,
/// Authentication is performed by including an access token in the request headers.
/// Authentication is performed by including an access token in the `Authentication` http
/// header, or an `access_token` query parameter.
///
/// It is recommended to use the header over the query parameter.
AccessToken,
/// Authentication is performed by including X-Matrix signatures in the request headers,
/// as defined in the federation API.
ServerSignatures,
/// Authentication is performed by including an access token in the query parameters.
/// Authentication is performed by setting the `access_token` query parameter.
QueryOnlyAccessToken,
}