openlark_workflow/v2/section/
get.rs

1//! 获取分组详情
2//!
3//! docPath: <https://open.feishu.cn/document/server-docs/docs/task-v2/section/get>
4
5use crate::common::api_endpoints::TaskApiV2;
6use crate::v2::section::models::GetSectionResponse;
7use openlark_core::{
8    SDKResult,
9    api::{ApiRequest, ApiResponseTrait, ResponseFormat},
10    config::Config,
11    validate_required,
12};
13use std::sync::Arc;
14
15/// 获取分组请求
16#[derive(Debug, Clone)]
17pub struct GetSectionRequest {
18    /// 配置信息
19    config: Arc<Config>,
20    /// 分组 GUID
21    section_guid: String,
22}
23
24impl GetSectionRequest {
25    /// 创建新的请求构建器。
26    pub fn new(config: Arc<Config>, section_guid: String) -> Self {
27        Self {
28            config,
29            section_guid,
30        }
31    }
32
33    /// 执行请求
34    pub async fn execute(self) -> SDKResult<GetSectionResponse> {
35        self.execute_with_options(openlark_core::req_option::RequestOption::default())
36            .await
37    }
38
39    /// 执行请求（带选项）
40    pub async fn execute_with_options(
41        self,
42        option: openlark_core::req_option::RequestOption,
43    ) -> SDKResult<GetSectionResponse> {
44        // 验证必填字段
45        validate_required!(self.section_guid.trim(), "分组GUID不能为空");
46
47        let api_endpoint = TaskApiV2::SectionGet(self.section_guid.clone());
48        let request = ApiRequest::<GetSectionResponse>::get(api_endpoint.to_url());
49
50        openlark_core::http::Transport::request_typed(
51            request,
52            &self.config,
53            Some(option),
54            "获取分组",
55        )
56        .await
57    }
58}
59
60impl ApiResponseTrait for GetSectionResponse {
61    fn data_format() -> ResponseFormat {
62        ResponseFormat::Data
63    }
64}
65
66#[cfg(test)]
67#[allow(unused_imports)]
68mod tests {
69    use std::sync::Arc;
70
71    use super::*;
72
73    #[test]
74    fn test_get_section_request() {
75        let config = openlark_core::config::Config::builder()
76            .app_id("test")
77            .app_secret("test")
78            .build();
79
80        let request = GetSectionRequest::new(Arc::new(config), "section_456".to_string());
81
82        assert_eq!(request.section_guid, "section_456");
83    }
84}
openlark_workflow/v2/section/get.rs

openlark_workflow/v2/section/
get.rs
