openlark_workflow/v1/task/comment/
update.rs

1//! 更新任务评论（v1）
2//!
3//! docPath: <https://open.feishu.cn/document/server-docs/docs/task-v1/taskcomment/update>
4
5use openlark_core::{
6    SDKResult,
7    api::{ApiRequest, ApiResponseTrait, ResponseFormat},
8    config::Config,
9    validate_required,
10};
11use serde::{Deserialize, Serialize};
12use std::sync::Arc;
13
14/// 更新任务评论请求体（v1）
15#[derive(Debug, Clone, Serialize, Default)]
16/// 更新任务评论请求体。
17pub struct UpdateTaskCommentBodyV1 {
18    /// 评论内容
19    pub content: String,
20}
21
22/// 更新任务评论响应（v1）
23#[derive(Debug, Clone, Deserialize)]
24/// 更新任务评论响应。
25pub struct UpdateTaskCommentResponseV1 {
26    /// 评论 ID
27    pub comment_id: String,
28    /// 评论内容
29    pub content: String,
30}
31
32/// 更新任务评论请求（v1）
33#[derive(Debug, Clone)]
34/// 更新任务评论请求构建器。
35pub struct UpdateTaskCommentRequestV1 {
36    config: Arc<Config>,
37    task_id: String,
38    comment_id: String,
39    body: UpdateTaskCommentBodyV1,
40}
41
42impl UpdateTaskCommentRequestV1 {
43    /// 创建新的请求构建器。
44    pub fn new(
45        config: Arc<Config>,
46        task_id: impl Into<String>,
47        comment_id: impl Into<String>,
48    ) -> Self {
49        Self {
50            config,
51            task_id: task_id.into(),
52            comment_id: comment_id.into(),
53            body: UpdateTaskCommentBodyV1::default(),
54        }
55    }
56
57    /// 设置评论内容
58    pub fn content(mut self, content: impl Into<String>) -> Self {
59        self.body.content = content.into();
60        self
61    }
62
63    /// 执行请求
64    pub async fn execute(self) -> SDKResult<UpdateTaskCommentResponseV1> {
65        self.execute_with_options(openlark_core::req_option::RequestOption::default())
66            .await
67    }
68
69    /// 执行请求（带选项）
70    pub async fn execute_with_options(
71        self,
72        option: openlark_core::req_option::RequestOption,
73    ) -> SDKResult<UpdateTaskCommentResponseV1> {
74        validate_required!(self.body.content.trim(), "评论内容不能为空");
75
76        let api_endpoint = crate::common::api_endpoints::TaskApiV1::TaskCommentUpdate(
77            self.task_id.clone(),
78            self.comment_id.clone(),
79        );
80        let mut request = ApiRequest::<UpdateTaskCommentResponseV1>::put(api_endpoint.to_url());
81
82        let body_json = serde_json::to_value(&self.body).map_err(|e| {
83            openlark_core::error::validation_error("序列化请求体失败", e.to_string().as_str())
84        })?;
85
86        request = request.body(body_json);
87
88        openlark_core::http::Transport::request_typed(
89            request,
90            &self.config,
91            Some(option),
92            "响应数据为空",
93        )
94        .await
95    }
96}
97
98impl ApiResponseTrait for UpdateTaskCommentResponseV1 {
99    fn data_format() -> ResponseFormat {
100        ResponseFormat::Data
101    }
102}
103
104#[cfg(test)]
105#[allow(unused_imports)]
106mod tests {
107    use std::sync::Arc;
108
109    use super::*;
110
111    #[test]
112    fn test_update_task_comment_v1_builder() {
113        let config = Arc::new(
114            openlark_core::config::Config::builder()
115                .app_id("test")
116                .app_secret("test")
117                .build(),
118        );
119
120        let request = UpdateTaskCommentRequestV1::new(config.clone(), "task_123", "comment_456")
121            .content("更新后的评论内容");
122
123        assert_eq!(request.body.content, "更新后的评论内容");
124    }
125
126    #[test]
127    fn test_task_comment_update_v1_url() {
128        let endpoint = crate::common::api_endpoints::TaskApiV1::TaskCommentUpdate(
129            "task_123".to_string(),
130            "comment_456".to_string(),
131        );
132        assert_eq!(
133            endpoint.to_url(),
134            "/open-apis/task/v1/tasks/task_123/comments/comment_456"
135        );
136    }
137}
openlark_workflow/v1/task/comment/update.rs

openlark_workflow/v1/task/comment/
update.rs
