Skip to main content

openlark_workflow/v2/tasklist/activity_subscription/
get.rs

1//! 获取动态订阅
2//!
3//! docPath: https://open.feishu.cn/document/server-docs/docs/task-v2/tasklist-activity_subscription/get
4
5use crate::common::{api_endpoints::TaskApiV2, api_utils::*};
6use crate::v2::tasklist::activity_subscription::models::GetActivitySubscriptionResponse;
7use openlark_core::{
8    api::{ApiRequest, ApiResponseTrait, ResponseFormat},
9    config::Config,
10    validate_required, SDKResult,
11};
12use std::sync::Arc;
13
14/// 获取动态订阅请求
15#[derive(Debug, Clone)]
16pub struct GetActivitySubscriptionRequest {
17    /// 配置信息
18    config: Arc<Config>,
19    /// 任务清单 GUID
20    tasklist_guid: String,
21    /// 订阅 GUID
22    subscription_guid: String,
23}
24
25impl GetActivitySubscriptionRequest {
26    pub fn new(
27        config: Arc<Config>,
28        tasklist_guid: impl Into<String>,
29        subscription_guid: impl Into<String>,
30    ) -> Self {
31        Self {
32            config,
33            tasklist_guid: tasklist_guid.into(),
34            subscription_guid: subscription_guid.into(),
35        }
36    }
37
38    /// 执行请求
39    pub async fn execute(self) -> SDKResult<GetActivitySubscriptionResponse> {
40        self.execute_with_options(openlark_core::req_option::RequestOption::default())
41            .await
42    }
43
44    /// 执行请求(带选项)
45    pub async fn execute_with_options(
46        self,
47        option: openlark_core::req_option::RequestOption,
48    ) -> SDKResult<GetActivitySubscriptionResponse> {
49        // 验证必填字段
50        validate_required!(self.tasklist_guid.trim(), "任务清单GUID不能为空");
51        validate_required!(self.subscription_guid.trim(), "订阅GUID不能为空");
52
53        let api_endpoint = TaskApiV2::ActivitySubscriptionGet(
54            self.tasklist_guid.clone(),
55            self.subscription_guid.clone(),
56        );
57        let request = ApiRequest::<GetActivitySubscriptionResponse>::get(api_endpoint.to_url());
58
59        let response =
60            openlark_core::http::Transport::request(request, &self.config, Some(option)).await?;
61        extract_response_data(response, "获取动态订阅")
62    }
63}
64
65impl ApiResponseTrait for GetActivitySubscriptionResponse {
66    fn data_format() -> ResponseFormat {
67        ResponseFormat::Data
68    }
69}
70
71#[cfg(test)]
72#[allow(unused_imports)]
73mod tests {
74    use std::sync::Arc;
75
76    use super::*;
77
78    #[test]
79    fn test_get_activity_subscription_request() {
80        let config = openlark_core::config::Config::builder()
81            .app_id("test")
82            .app_secret("test")
83            .build();
84
85        let request = GetActivitySubscriptionRequest::new(
86            Arc::new(config),
87            "tasklist_123",
88            "subscription_456",
89        );
90
91        assert_eq!(request.tasklist_guid, "tasklist_123");
92        assert_eq!(request.subscription_guid, "subscription_456");
93    }
94
95    #[test]
96    fn test_activity_subscription_get_api_v2_url() {
97        let endpoint = TaskApiV2::ActivitySubscriptionGet(
98            "tasklist_123".to_string(),
99            "subscription_456".to_string(),
100        );
101        assert_eq!(
102            endpoint.to_url(),
103            "/open-apis/task/v2/tasklists/tasklist_123/activity_subscriptions/subscription_456"
104        );
105    }
106}