botx-api 0.1.6

Обертка над BotX api (eXpress)
Documentation 
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use uuid::Uuid;


/// Ответ сервера на запрос состояния сообщения
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct EventStatusResponse {
    /// Результат
    pub result: EventStatusResult,
}


/// Результат запроса статуса сообщения 
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct EventStatusResult {
    /// Идентификатор чата
    pub group_chat_id: Uuid,

    /// Список идентификаторов устройств (uuid), получивших событие
    pub sent_to: Vec<Uuid>,

    /// Список пользователей, которые прочли сообщение
    pub read_by: Vec<EventReadBy>,

    /// Список пользователей, которым доставлено сообщение
    pub received_by: Vec<EventReceivedBy>,
}

/// Информация о пользователе, который прочел сообщение
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct EventReadBy {
    /// huid пользователя прочитавшего событие
    pub user_huid: Uuid,

    /// Время прочтения
    pub read_at: DateTime<Utc>,
}

/// Информация о пользователе получившем сообщение
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct EventReceivedBy {
    /// huid пользователя получившего событие
    pub user_huid: Uuid,

    /// Время получения
    pub received_at: DateTime<Utc>,
}

/// Ошибки при запросе состояния сообщения
#[derive(Debug, Serialize, Deserialize, Clone)]
#[serde(tag = "reason")]
pub enum EventStatusError {
    /// Событие не найдено (404)
    #[serde(rename(serialize = "event_not_found", deserialize = "event_not_found"))]
    EventNotFound(EventNotFound),

    /// Событие не найдено (404)
    #[serde(rename(serialize = "messaging_service_error", deserialize = "messaging_service_error"))]
    MessagingServiceError(MessagingServiceError),

    // TODO: добавить десериализацию в HashMap<string, string> когда завезут реализацию
    /// Неопределенная ошибка, смотрите логи
    #[serde(other)]
    Other,
}


/// Событие не найдено (404)
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct EventNotFound {
    /// Список ошибок
    pub errors: Vec<String>,

    /// Дополнительная информация об ошибке
    pub error_data: EventNotFoundData,
}

#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct EventNotFoundData {
    /// uuid сообщения
    pub sync_id: Uuid
}

/// Ошибка messaging сервиса при запросе события (500)
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct MessagingServiceError {
    /// Список ошибок
    pub errors: Vec<String>,

    /// Дополнительная информация об ошибке
    pub error_data: MessagingServiceErrorData,
}

#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct MessagingServiceErrorData {
    /// uuid сообщения
    pub sync_id: Uuid
}