ruma_client_api/discovery/
get_authentication_issuer.rs

1//! `GET /_matrix/client/*/auth_issuer`
2//!
3//! Get the OpenID Connect Provider that is trusted by the homeserver.
4//!
5//! This endpoint has been replaced by [`get_authorization_server_metadata`] in [MSC2965].
6//!
7//! [`get_authorization_server_metadata`]: super::get_authorization_server_metadata
8//! [MSC2965]: https://github.com/matrix-org/matrix-spec-proposals/pull/2965
9
10pub mod msc2965 {
11    //! `MSC2965` ([MSC])
12    //!
13    //! [MSC]: https://github.com/matrix-org/matrix-spec-proposals/pull/2965
14
15    use ruma_common::{
16        api::{request, response, Metadata},
17        metadata,
18    };
19
20    const METADATA: Metadata = metadata! {
21        method: GET,
22        rate_limited: false,
23        authentication: None,
24        history: {
25            unstable => "/_matrix/client/unstable/org.matrix.msc2965/auth_issuer",
26        }
27    };
28
29    /// Request type for the `auth_issuer` endpoint.
30    #[request(error = crate::Error)]
31    #[derive(Default)]
32    #[deprecated = "Replaced by the get_authorization_server_metadata endpoint."]
33    pub struct Request {}
34
35    /// Request type for the `auth_issuer` endpoint.
36    #[response(error = crate::Error)]
37    pub struct Response {
38        /// The OpenID Connect Provider that is trusted by the homeserver.
39        pub issuer: String,
40    }
41
42    #[allow(deprecated)]
43    impl Request {
44        /// Creates a new empty `Request`.
45        pub fn new() -> Self {
46            Self {}
47        }
48    }
49
50    impl Response {
51        /// Creates a new `Response` with the given issuer.
52        pub fn new(issuer: String) -> Self {
53            Self { issuer }
54        }
55    }
56}