1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
//! `PUT /_matrix/federation/*/exchange_third_party_invite/{roomId}`
//!
//! The receiving server will verify the partial `m.room.member` event given in the request body.
//! If valid, the receiving server will issue an invite as per the [Inviting to a room] section
//! before returning a response to this request.
//!
//! [Inviting to a room]: https://spec.matrix.org/v1.2/server-server-api/#inviting-to-a-room
pub mod v1 {
//! `/v1/` ([spec])
//!
//! [spec]: https://spec.matrix.org/v1.2/server-server-api/#put_matrixfederationv1exchange_third_party_inviteroomid
use ruma_common::{
api::ruma_api,
events::{room::member::ThirdPartyInvite, StateEventType},
RoomId, UserId,
};
ruma_api! {
metadata: {
description: "The receiving server will verify the partial m.room.member event given in the request body.",
method: PUT,
name: "exchange_invite",
stable_path: "/_matrix/federation/v1/exchange_third_party_invite/:room_id",
rate_limited: false,
authentication: AccessToken,
added: 1.0,
}
request: {
/// The room ID to exchange a third party invite in.
#[ruma_api(path)]
pub room_id: &'a RoomId,
/// The event type.
///
/// Must be `StateEventType::RoomMember`.
#[serde(rename = "type")]
pub kind: StateEventType,
/// The user ID of the user who sent the original invite event.
pub sender: &'a UserId,
/// The user ID of the invited user.
pub state_key: &'a UserId,
/// The content of the invite event.
pub content: &'a ThirdPartyInvite,
}
#[derive(Default)]
response: {}
}
impl<'a> Request<'a> {
/// Creates a new `Request` for a third party invite exchange
pub fn new(
room_id: &'a RoomId,
sender: &'a UserId,
state_key: &'a UserId,
content: &'a ThirdPartyInvite,
) -> Self {
Self { room_id, kind: StateEventType::RoomMember, sender, state_key, content }
}
}
impl Response {
/// Creates a new `Response`.
pub fn new() -> Self {
Self {}
}
}
}