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 75
//! `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/latest/server-server-api/#inviting-to-a-room
pub mod v1 {
//! `/v1/` ([spec])
//!
//! [spec]: https://spec.matrix.org/latest/server-server-api/#put_matrixfederationv1exchange_third_party_inviteroomid
use ruma_common::{
api::{request, response, Metadata},
metadata, OwnedRoomId, OwnedUserId,
};
use ruma_events::{room::member::ThirdPartyInvite, StateEventType};
const METADATA: Metadata = metadata! {
method: PUT,
rate_limited: false,
authentication: AccessToken,
history: {
1.0 => "/_matrix/federation/v1/exchange_third_party_invite/:room_id",
}
};
/// Request type for the `exchange_invite` endpoint.
#[request]
pub struct Request {
/// The room ID to exchange a third party invite in.
#[ruma_api(path)]
pub room_id: OwnedRoomId,
/// 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: OwnedUserId,
/// The user ID of the invited user.
pub state_key: OwnedUserId,
/// The content of the invite event.
pub content: ThirdPartyInvite,
}
/// Response type for the `exchange_invite` endpoint.
#[response]
#[derive(Default)]
pub struct Response {}
impl Request {
/// Creates a new `Request` for a third party invite exchange
pub fn new(
room_id: OwnedRoomId,
sender: OwnedUserId,
state_key: OwnedUserId,
content: ThirdPartyInvite,
) -> Self {
Self { room_id, kind: StateEventType::RoomMember, sender, state_key, content }
}
}
impl Response {
/// Creates a new `Response`.
pub fn new() -> Self {
Self {}
}
}
}