unifly-api 0.9.0

Async Rust client, reactive data layer, and domain model for UniFi controller APIs
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

// Session API system log endpoints (v2)
//
// Covers client connection timeline queries from the raw JSON system-log
// surface.

use serde_json::Value;
use tracing::debug;

use crate::error::Error;
use crate::session::client::SessionClient;

impl SessionClient {
    /// Get a client's connection timeline: connects, disconnects, and roams.
    ///
    /// `GET /v2/api/site/{site}/system-log/client-connection/{mac}`
    ///
    /// **Quirk:** the MAC must appear in both the URL path and the
    /// `?mac=` query parameter.
    pub async fn get_client_roams(
        &self,
        mac: &str,
        limit: Option<u32>,
    ) -> Result<Vec<Value>, Error> {
        let limit = limit.unwrap_or(200);
        let path = format!(
            "system-log/client-connection/{mac}?mac={mac}&separateConnectionSignalParam=false&limit={limit}"
        );
        let url = self.site_url_v2(&path);
        debug!(mac, limit, "fetching client roam timeline");
        let value = self.get_raw(url).await?;
        Ok(match value {
            Value::Array(items) => items,
            other => vec![other],
        })
    }
}