120 lines
4.0 KiB
Rust
120 lines
4.0 KiB
Rust
//! Endpoints for sending events.
|
|
|
|
/// [PUT /_matrix/client/r0/rooms/{roomId}/state/{eventType}](https://matrix.org/docs/spec/client_server/r0.2.0.html#put-matrix-client-r0-rooms-roomid-state-eventtype)
|
|
pub mod send_state_event_for_empty_key {
|
|
use ruma_api_macros::ruma_api;
|
|
use ruma_identifiers::{RoomId, EventId};
|
|
use ruma_events::EventType;
|
|
use serde_json::Value;
|
|
|
|
ruma_api! {
|
|
metadata {
|
|
description: "Send a state event to a room associated with the empty state key.",
|
|
method: PUT,
|
|
name: "send_state_event_for_empty_key",
|
|
path: "/_matrix/client/r0/rooms/:room_id/state/:event_type",
|
|
rate_limited: false,
|
|
requires_authentication: true,
|
|
}
|
|
|
|
request {
|
|
/// The room to set the state in.
|
|
#[ruma_api(path)]
|
|
pub room_id: RoomId,
|
|
/// The type of event to send.
|
|
#[ruma_api(path)]
|
|
pub event_type: EventType,
|
|
/// The event's content.
|
|
#[ruma_api(body)]
|
|
pub data: Value,
|
|
}
|
|
|
|
response {
|
|
/// A unique identifier for the event.
|
|
pub event_id: EventId,
|
|
}
|
|
}
|
|
}
|
|
|
|
/// [PUT /_matrix/client/r0/rooms/{roomId}/state/{eventType}/{stateKey}](https://matrix.org/docs/spec/client_server/r0.2.0.html#put-matrix-client-r0-rooms-roomid-state-eventtype-statekey)
|
|
pub mod send_state_event_for_key {
|
|
use ruma_api_macros::ruma_api;
|
|
use ruma_identifiers::{RoomId, EventId};
|
|
use ruma_events::EventType;
|
|
use serde_json::Value;
|
|
|
|
ruma_api! {
|
|
metadata {
|
|
description: "Send a state event to a room associated with a given state key.",
|
|
method: PUT,
|
|
name: "send_state_event_for_key",
|
|
path: "/_matrix/client/r0/rooms/:room_id/state/:event_type/:state_key",
|
|
rate_limited: false,
|
|
requires_authentication: true,
|
|
}
|
|
|
|
request {
|
|
/// The room to set the state in.
|
|
#[ruma_api(path)]
|
|
pub room_id: RoomId,
|
|
/// The type of event to send.
|
|
#[ruma_api(path)]
|
|
pub event_type: EventType,
|
|
/// The state_key for the state to send. Defaults to the empty string.
|
|
#[ruma_api(path)]
|
|
pub state_key: String,
|
|
/// The event's content.
|
|
#[ruma_api(body)]
|
|
pub data: Value,
|
|
}
|
|
|
|
response {
|
|
/// A unique identifier for the event.
|
|
pub event_id: EventId,
|
|
}
|
|
}
|
|
}
|
|
|
|
/// [PUT /_matrix/client/r0/rooms/{roomId}/send/{eventType}/{txnId}](https://matrix.org/docs/spec/client_server/r0.2.0.html#put-matrix-client-r0-rooms-roomid-send-eventtype-txnid)
|
|
pub mod send_message_event {
|
|
use ruma_api_macros::ruma_api;
|
|
use ruma_identifiers::{RoomId, EventId};
|
|
use ruma_events::EventType;
|
|
use ruma_events::room::message::MessageEventContent;
|
|
|
|
ruma_api! {
|
|
metadata {
|
|
description: "Send a message event to a room.",
|
|
method: PUT,
|
|
name: "send_message_event",
|
|
path: "/_matrix/client/r0/rooms/:room_id/send/:event_type/:txn_id",
|
|
rate_limited: false,
|
|
requires_authentication: true,
|
|
}
|
|
|
|
request {
|
|
/// The room to send the event to.
|
|
#[ruma_api(path)]
|
|
pub room_id: RoomId,
|
|
/// The type of event to send.
|
|
#[ruma_api(path)]
|
|
pub event_type: EventType,
|
|
/// The transaction ID for this event.
|
|
///
|
|
/// Clients should generate an ID unique across requests with the
|
|
/// same access token; it will be used by the server to ensure
|
|
/// idempotency of requests.
|
|
#[ruma_api(path)]
|
|
pub txn_id: String,
|
|
/// The event's content.
|
|
#[ruma_api(body)]
|
|
pub data: MessageEventContent,
|
|
}
|
|
|
|
response {
|
|
/// A unique identifier for the event.
|
|
pub event_id: EventId,
|
|
}
|
|
}
|
|
}
|