unosend 1.0.0

Official Rust SDK for Unosend - Email API for developers
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

use crate::client::Unosend;
use crate::error::UnosendError;
use serde::{Deserialize, Serialize};

/// Contact management API.
pub struct ContactsApi {
    client: Unosend,
}

impl ContactsApi {
    pub(crate) fn new(client: Unosend) -> Self {
        Self { client }
    }

    /// Create a new contact.
    pub async fn create(&self, request: CreateContactRequest) -> Result<Contact, UnosendError> {
        self.client.post("/contacts", &request).await
    }

    /// List contacts in an audience.
    pub async fn list(&self, audience_id: &str) -> Result<ContactList, UnosendError> {
        self.client
            .get(&format!("/audiences/{}/contacts", audience_id))
            .await
    }

    /// Get a contact by ID.
    pub async fn get(&self, contact_id: &str) -> Result<Contact, UnosendError> {
        self.client.get(&format!("/contacts/{}", contact_id)).await
    }

    /// Delete a contact.
    pub async fn delete(&self, contact_id: &str) -> Result<(), UnosendError> {
        self.client.delete(&format!("/contacts/{}", contact_id)).await
    }
}

/// Request to create a contact.
#[derive(Debug, Clone, Serialize)]
pub struct CreateContactRequest {
    pub audience_id: String,
    pub email: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub first_name: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub last_name: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub unsubscribed: Option<bool>,
}

/// Contact information.
#[derive(Debug, Clone, Deserialize)]
pub struct Contact {
    pub id: String,
    pub email: String,
    pub first_name: Option<String>,
    pub last_name: Option<String>,
    pub unsubscribed: bool,
    pub created_at: String,
}

/// List of contacts.
#[derive(Debug, Clone, Deserialize)]
pub struct ContactList {
    pub data: Vec<Contact>,
}