Skip to main content

postmark/api/messages/
single_message_clicks.rs

1use std::borrow::Cow;
2
3use serde::Serialize;
4use typed_builder::TypedBuilder;
5use url::form_urlencoded::Serializer;
6
7use crate::Endpoint;
8use crate::api::messages::MessageClicksResponse;
9use crate::api::{endpoint_with_path_segment, endpoint_with_query};
10
11#[derive(Debug, Clone, PartialEq, Serialize, TypedBuilder)]
12#[builder(field_defaults(default, setter(strip_option)))]
13#[serde(rename_all = "PascalCase")]
14pub struct SingleMessageClicksRequest {
15    #[builder(setter(!strip_option))]
16    #[serde(skip)]
17    pub message_id: String,
18    #[serde(skip_serializing_if = "Option::is_none")]
19    pub count: Option<i64>,
20    #[serde(skip_serializing_if = "Option::is_none")]
21    pub offset: Option<i64>,
22}
23
24impl Endpoint for SingleMessageClicksRequest {
25    type Request = SingleMessageClicksRequest;
26    type Response = MessageClicksResponse;
27
28    fn endpoint(&self) -> Cow<'static, str> {
29        let mut serializer = Serializer::new(String::new());
30
31        if let Some(count) = self.count {
32            serializer.append_pair("count", &count.to_string());
33        }
34        if let Some(offset) = self.offset {
35            serializer.append_pair("offset", &offset.to_string());
36        }
37
38        let path = endpoint_with_path_segment("/messages/outbound/clicks", &self.message_id);
39        endpoint_with_query(path.as_ref(), serializer.finish())
40    }
41
42    fn body(&self) -> &Self::Request {
43        self
44    }
45
46    fn method(&self) -> http::Method {
47        http::Method::GET
48    }
49}
50
51#[cfg(test)]
52mod tests {
53    use httptest::matchers::request;
54    use httptest::{Expectation, Server, responders::*};
55    use serde_json::json;
56
57    use super::*;
58    use crate::Query;
59    use crate::reqwest::PostmarkClient;
60
61    #[tokio::test]
62    async fn single_message_clicks_gets_events() {
63        let server = Server::run();
64
65        server.expect(
66            Expectation::matching(request::method_path(
67                "GET",
68                "/messages/outbound/clicks/out-msg-1",
69            ))
70            .respond_with(json_encoded(json!({
71                "TotalCount": 1,
72                "Clicks": [
73                    {
74                        "MessageID": "out-msg-1",
75                        "OriginalLink": "https://example.com"
76                    }
77                ]
78            }))),
79        );
80
81        let client = PostmarkClient::builder()
82            .base_url(server.url("/").to_string())
83            .build();
84        let req = SingleMessageClicksRequest::builder()
85            .message_id("out-msg-1".to_string())
86            .build();
87
88        let resp = req
89            .execute(&client)
90            .await
91            .expect("Should decode single message clicks");
92
93        assert_eq!(resp.total_count, 1);
94        assert_eq!(resp.clicks[0].message_id, "out-msg-1");
95    }
96}