Struct ruma::api::federation::discovery::get_remote_server_keys_batch::v2::Request

pub struct Request {
    pub server_keys: BTreeMap<Box<ServerName, Global>, BTreeMap<KeyId<SigningKeyAlgorithm, KeyName>, QueryCriteria>>,
    pub minimum_valid_until_ts: MilliSecondsSinceUnixEpoch,
}

This is supported on crate feature api and (crate features federation-api or federation-api-c or federation-api-s) only.

Data for a request to the get_remote_server_keys_batch API endpoint.

Query for keys from multiple servers in a batch format.

Fields

server_keys: BTreeMap<Box<ServerName, Global>, BTreeMap<KeyId<SigningKeyAlgorithm, KeyName>, QueryCriteria>>

The query criteria. The outer string key on the object is the server name (eg: matrix.org). The inner string key is the Key ID to query for the particular server. If no key IDs are given to be queried, the notary server should query for all keys. If no servers are given, the notary server must return an empty server_keys array in the response.

The notary server may return multiple keys regardless of the Key IDs given.

minimum_valid_until_ts: MilliSecondsSinceUnixEpoch

A millisecond POSIX timestamp in milliseconds indicating when the returned certificates will need to be valid until to be useful to the requesting server.

If not supplied, the current time as determined by the notary server is used.

Implementations

impl Request

pub fn new(
    server_keys: BTreeMap<Box<ServerName, Global>, BTreeMap<KeyId<SigningKeyAlgorithm, KeyName>, QueryCriteria>>,
    minimum_valid_until_ts: MilliSecondsSinceUnixEpoch
) -> Request

Creates a new Request with the given query criteria and minimum_valid_until timestamp.

Trait Implementations

impl Clone for Request

pub fn clone(&self) -> Request

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Request

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl IncomingRequest for Request

type EndpointError = MatrixError

A type capturing the error conditions that can be returned in the response.

type OutgoingResponse = Response

Response type to return when the request is successful.

pub const METADATA: Metadata

Metadata about the endpoint.

pub fn try_from_http_request<T>(
    request: Request<T>
) -> Result<Request, FromHttpRequestError> where
    T: AsRef<[u8]>, 

Tries to turn the given http::Request into this request type.

impl Outgoing for Request

type Incoming = Request

The ‘Incoming’ variant of Self.

impl OutgoingRequest for Request

type EndpointError = MatrixError

A type capturing the expected error conditions the server can return.

type IncomingResponse = <Response as Outgoing>::Incoming

Response type returned when the request is successful.

pub const METADATA: Metadata

Metadata about the endpoint.

pub fn try_into_http_request<T>(
    self,
    base_url: &str,
    access_token: SendAccessToken<'_>
) -> Result<Request<T>, IntoHttpError> where
    T: Default + BufMut, 

Tries to convert this request into an http::Request.

impl IncomingNonAuthRequest for Request

impl OutgoingNonAuthRequest for Request