sevk 1.0.0

Rust SDK for Sevk API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! Segments resource

use crate::client::Client;
use crate::error::Error;
use crate::types::{
    CreateSegmentRequest, EmptyResponse, ListParams, PaginatedList, Segment,
    SegmentCalculateRequest, SegmentCalculateResponse, UpdateSegmentRequest,
};

/// Segments API resource
pub struct Segments<'a> {
    client: &'a Client,
}

impl<'a> Segments<'a> {
    /// Create a new Segments resource
    pub fn new(client: &'a Client) -> Self {
        Self { client }
    }

    /// List all segments for an audience
    pub async fn list(
        &self,
        audience_id: &str,
        params: Option<ListParams>,
    ) -> Result<PaginatedList<Segment>, Error> {
        let params = params.unwrap_or_default();
        let query_params = params.to_query_params();
        self.client
            .get_with_params(&format!("/audiences/{}/segments", audience_id), &query_params)
            .await
    }

    /// Get a segment by ID
    pub async fn get(&self, audience_id: &str, id: &str) -> Result<Segment, Error> {
        self.client
            .get(&format!("/audiences/{}/segments/{}", audience_id, id))
            .await
    }

    /// Create a new segment
    pub async fn create(&self, audience_id: &str, data: CreateSegmentRequest) -> Result<Segment, Error> {
        self.client
            .post(&format!("/audiences/{}/segments", audience_id), &data)
            .await
    }

    /// Update a segment
    pub async fn update(
        &self,
        audience_id: &str,
        id: &str,
        data: UpdateSegmentRequest,
    ) -> Result<Segment, Error> {
        self.client
            .put(&format!("/audiences/{}/segments/{}", audience_id, id), &data)
            .await
    }

    /// Delete a segment
    pub async fn delete(&self, audience_id: &str, id: &str) -> Result<EmptyResponse, Error> {
        self.client
            .delete(&format!("/audiences/{}/segments/{}", audience_id, id))
            .await
    }

    /// Calculate a segment's matching contacts
    pub async fn calculate(
        &self,
        audience_id: &str,
        segment_id: &str,
    ) -> Result<SegmentCalculateResponse, Error> {
        self.client
            .get(&format!(
                "/audiences/{}/segments/{}/calculate",
                audience_id, segment_id
            ))
            .await
    }

    /// Preview how many contacts match given segment rules before saving
    pub async fn preview(
        &self,
        audience_id: &str,
        data: SegmentCalculateRequest,
    ) -> Result<SegmentCalculateResponse, Error> {
        self.client
            .post(
                &format!("/audiences/{}/segments/preview", audience_id),
                &data,
            )
            .await
    }
}