ring-client 0.1.3

A Rust client for interfacing with Ring home security devices.
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

use crate::client::api::RingApi;
use crate::client::api::error::ApiError;
use crate::client::authentication::Tokens;
use crate::helper::url::Url;
use crate::{constant, helper};
use serde::Deserialize;
use serde_json::{Value, json};
use std::collections::HashMap;

/// The profile data for the logged in user.
#[derive(Deserialize, Debug)]
pub struct Profile {
    /// The ID of the user.
    pub id: usize,

    /// The email address of the user.
    pub email: String,

    /// The first name of the user.
    pub first_name: String,

    /// The last name of the user.
    pub last_name: String,

    #[serde(flatten)]
    #[allow(missing_docs)]
    pub extra: HashMap<String, Value>,
}

/// An active session
#[derive(Deserialize, Debug)]
#[allow(missing_docs)]
pub struct Session {
    pub profile: Profile,
}

impl RingApi {
    pub async fn set_session(
        &self,
        display_name: &str,
        system_id: &str,
        tokens: &Tokens,
    ) -> Result<Session, ApiError> {
        Ok(self
            .client
            .post(helper::url::get_base_url(&Url::Session))
            .header("User-Agent", self.operating_system.get_user_agent())
            .bearer_auth(&tokens.access_token)
            .json(&json!({
                "device": {
                    "hardware_id": helper::hardware::generate_hardware_id(system_id),
                    "os": self.operating_system.to_string(),
                    "metadata": {
                        "api_version": constant::API_VERSION,
                        "device_model": display_name
                    }
                }
            }))
            .send()
            .await?
            .json::<Session>()
            .await?)
    }
}