openlark-docs 0.17.0

飞书开放平台云文档服务模块 - 文档、表格、知识库API (202 APIs, 100% 覆盖，不含旧版本)
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

/// CCM Drive Permission V2 数据模型
use serde::{Deserialize, Serialize};

/// 判断协作者是否有某权限请求参数
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CheckMemberPermissionParams {
    /// 文件token
    #[serde(rename = "obj_token")]
    pub obj_token: String,
    /// 权限类型
    pub permission: String,
    /// 用户ID（可选，默认为当前用户）
    #[serde(rename = "member_id")]
    pub member_id: Option<String>,
    /// 用户ID类型
    #[serde(rename = "member_id_type")]
    pub member_id_type: Option<String>,
}

/// 判断协作者是否有某权限响应
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CheckMemberPermissionResponse {
    /// 权限检查结果
    pub data: Option<PermissionCheckResult>,
}

/// 权限检查结果
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PermissionCheckResult {
    /// 是否有权限
    pub permitted: bool,
    /// 权限详情
    pub permission: Option<String>,
}

/// 转移拥有者请求参数
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TransferOwnerParams {
    /// 文件token
    #[serde(rename = "obj_token")]
    pub obj_token: String,
    /// 新拥有者用户ID
    #[serde(rename = "member_id")]
    pub member_id: String,
    /// 用户ID类型
    #[serde(rename = "member_id_type")]
    pub member_id_type: String,
}

/// 转移拥有者响应
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TransferOwnerResponse {
    /// 转移结果
    pub data: Option<TransferResult>,
}

/// 转移结果
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TransferResult {
    /// 是否成功
    pub success: bool,
    /// 错误信息
    pub error: Option<String>,
}

/// 获取云文档权限设置V2请求参数
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GetPublicPermissionParams {
    /// 文件token
    #[serde(rename = "obj_token")]
    pub obj_token: String,
}

/// 获取云文档权限设置V2响应
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GetPublicPermissionResponse {
    /// 权限设置信息
    pub data: Option<PublicPermission>,
}

/// 公开权限信息
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PublicPermission {
    /// 是否公开
    #[serde(rename = "is_public")]
    pub is_public: bool,
    /// 公开链接
    #[serde(rename = "public_link")]
    pub public_link: Option<String>,
    /// 权限类型
    #[serde(rename = "link_type")]
    pub link_type: Option<String>,
    /// 是否需要密码
    #[serde(rename = "need_password")]
    pub need_password: bool,
    /// 过期时间
    #[serde(rename = "expire_time")]
    pub expire_time: Option<i64>,
}

/// 用户信息
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct UserInfo {
    /// 用户ID
    #[serde(rename = "open_id")]
    pub open_id: String,
    /// 用户名称
    pub name: String,
}

#[cfg(test)]
mod tests {

    use serde_json;

    #[test]
    fn test_serialization_roundtrip() {
        // 基础序列化测试
        let json = r#"{"test": "value"}"#;
        assert!(serde_json::from_str::<serde_json::Value>(json).is_ok());
    }

    #[test]
    fn test_deserialization_from_json() {
        // 基础反序列化测试
        let json = r#"{"field": "data"}"#;
        let value: serde_json::Value = serde_json::from_str(json).expect("JSON 反序列化失败");
        assert_eq!(value["field"], "data");
    }
}