openlark_workflow/v2/task/
remove_tasklist.rs

1//! 任务移出清单
2//!
3//! docPath: https://open.feishu.cn/document/server-docs/docs/task-v2/task-remove_tasklist/create
4
5use crate::common::{api_endpoints::TaskApiV2, api_utils::*};
6use openlark_core::{
7    api::{ApiRequest, ApiResponseTrait, ResponseFormat},
8    config::Config,
9    validate_required, SDKResult,
10};
11use serde::{Deserialize, Serialize};
12use std::sync::Arc;
13
14/// 任务移出清单请求体
15#[derive(Debug, Clone, Serialize, Default)]
16pub struct RemoveTasklistBody {
17    /// 任务清单 GUID
18    pub tasklist_guid: String,
19}
20
21/// 任务移出清单响应
22#[derive(Debug, Clone, Deserialize)]
23pub struct RemoveTasklistResponse {
24    /// 任务 GUID
25    pub task_guid: String,
26    /// 任务清单 GUID
27    pub tasklist_guid: String,
28}
29
30/// 任务移出清单请求
31#[derive(Debug, Clone)]
32pub struct RemoveTasklistRequest {
33    /// 配置信息
34    config: Arc<Config>,
35    /// 任务 GUID
36    task_guid: String,
37    /// 请求体
38    body: RemoveTasklistBody,
39}
40
41impl RemoveTasklistRequest {
42    pub fn new(config: Arc<Config>, task_guid: impl Into<String>) -> Self {
43        Self {
44            config,
45            task_guid: task_guid.into(),
46            body: RemoveTasklistBody::default(),
47        }
48    }
49
50    /// 设置任务清单 GUID
51    pub fn tasklist_guid(mut self, tasklist_guid: impl Into<String>) -> Self {
52        self.body.tasklist_guid = tasklist_guid.into();
53        self
54    }
55
56    /// 执行请求
57    pub async fn execute(self) -> SDKResult<RemoveTasklistResponse> {
58        self.execute_with_options(openlark_core::req_option::RequestOption::default())
59            .await
60    }
61
62    /// 执行请求（带选项）
63    pub async fn execute_with_options(
64        self,
65        option: openlark_core::req_option::RequestOption,
66    ) -> SDKResult<RemoveTasklistResponse> {
67        // 验证必填字段
68        validate_required!(self.task_guid.trim(), "任务GUID不能为空");
69        validate_required!(self.body.tasklist_guid.trim(), "任务清单GUID不能为空");
70
71        let api_endpoint = TaskApiV2::TaskRemoveTasklist(self.task_guid.clone());
72        let mut request = ApiRequest::<RemoveTasklistResponse>::post(api_endpoint.to_url());
73
74        let request_body = &self.body;
75        request = request.body(serialize_params(request_body, "任务移出清单")?);
76
77        let response =
78            openlark_core::http::Transport::request(request, &self.config, Some(option)).await?;
79        extract_response_data(response, "任务移出清单")
80    }
81}
82
83impl ApiResponseTrait for RemoveTasklistResponse {
84    fn data_format() -> ResponseFormat {
85        ResponseFormat::Data
86    }
87}
88
89#[cfg(test)]
90#[allow(unused_imports)]
91mod tests {
92    use std::sync::Arc;
93
94    use super::*;
95
96    #[test]
97    fn test_remove_tasklist_builder() {
98        let config = Arc::new(
99            openlark_core::config::Config::builder()
100                .app_id("test")
101                .app_secret("test")
102                .build(),
103        );
104
105        let request = RemoveTasklistRequest::new(config, "task_123").tasklist_guid("tasklist_456");
106
107        assert_eq!(request.task_guid, "task_123");
108        assert_eq!(request.body.tasklist_guid, "tasklist_456");
109    }
110
111    #[test]
112    fn test_task_remove_tasklist_api_v2_url() {
113        let endpoint = TaskApiV2::TaskRemoveTasklist("task_123".to_string());
114        assert_eq!(
115            endpoint.to_url(),
116            "/open-apis/task/v2/tasks/task_123/remove_tasklist"
117        );
118    }
119}
openlark_workflow/v2/task/remove_tasklist.rs

openlark_workflow/v2/task/
remove_tasklist.rs
