meegle/comment/
api.rs

1use super::types::*;
2use crate::client::{AuthType, Client};
3use crate::error::ApiResult;
4
5pub trait CommentApi {
6    /// 添加评论
7    /// 该接口用于在指定工作项下添加一条评论，添加的评论内容会出现在工作项详情页——评论/备注tab页中，并会显示该评论由插件添加。
8    fn create_comment(
9        &self,
10        request: CreateCommentRequest,
11        auth: AuthType,
12    ) -> impl std::future::Future<Output = ApiResult<CreateCommentResponse>> + Send;
13
14    /// 获取评论
15    /// 该接口用于获取指定工作项下的所有评论信息
16    fn get_comments(
17        &self,
18        request: GetCommentsRequest,
19        auth: AuthType,
20    ) -> impl std::future::Future<Output = ApiResult<GetCommentsResponse>> + Send;
21
22    /// 更新评论
23    /// 该接口用于对指定评论更新其内容，被更新的评论会显示该评论由插件添加。
24    fn update_comment(
25        &self,
26        request: UpdateCommentRequest,
27        auth: AuthType,
28    ) -> impl std::future::Future<Output = ApiResult<UpdateCommentResponse>> + Send;
29
30    /// 删除评论
31    /// 该接口用于删除工作项下一条指定的评论信息
32    fn delete_comment(
33        &self,
34        request: DeleteCommentRequest,
35        auth: AuthType,
36    ) -> impl std::future::Future<Output = ApiResult<DeleteCommentResponse>> + Send;
37}
38
39impl CommentApi for Client {
40    async fn create_comment(
41        &self,
42        request: CreateCommentRequest,
43        auth: AuthType,
44    ) -> ApiResult<CreateCommentResponse> {
45        Ok(self
46            .post(
47                &format!(
48                    "{}/work_item/{}/{}/comment/create",
49                    request.project_key, request.work_item_type_key, request.work_item_id
50                ),
51                &request,
52                auth,
53            )
54            .await?)
55    }
56
57    async fn get_comments(
58        &self,
59        request: GetCommentsRequest,
60        auth: AuthType,
61    ) -> ApiResult<GetCommentsResponse> {
62        let mut url = format!(
63            "{}/work_item/{}/{}/comments",
64            request.project_key, request.work_item_type_key, request.work_item_id
65        );
66
67        if let Some(page_size) = request.page_size {
68            url.push_str(&format!("?page_size={}", page_size));
69            if let Some(page_num) = request.page_num {
70                url.push_str(&format!("&page_num={}", page_num));
71            }
72        }
73
74        Ok(self.get(&url, auth).await?)
75    }
76
77    async fn update_comment(
78        &self,
79        request: UpdateCommentRequest,
80        auth: AuthType,
81    ) -> ApiResult<UpdateCommentResponse> {
82        Ok(self
83            .put(
84                &format!(
85                    "{}/work_item/{}/{}/comment/{}",
86                    request.project_key,
87                    request.work_item_type_key,
88                    request.work_item_id,
89                    request.comment_id
90                ),
91                &request,
92                auth,
93            )
94            .await?)
95    }
96
97    async fn delete_comment(
98        &self,
99        request: DeleteCommentRequest,
100        auth: AuthType,
101    ) -> ApiResult<DeleteCommentResponse> {
102        Ok(self
103            .delete(
104                &format!(
105                    "{}/work_item/{}/{}/comment/{}",
106                    request.project_key,
107                    request.work_item_type_key,
108                    request.work_item_id,
109                    request.comment_id
110                ),
111                auth,
112            )
113            .await?)
114    }
115}
meegle/comment/api.rs

meegle/comment/
api.rs
