akahu-client 0.1.1

A non-official Rust client library for the Akahu API, providing access to financial data aggregation services in New Zealand
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

//! Akahu API client implementation.

mod accounts;
mod core;
mod me;
mod refresh;
mod transactions;

use crate::{AppSecret, AppToken};

/// Default base URL for the Akahu API
const DEFAULT_BASE_URL: &str = "https://api.akahu.io/v1";

/// The main Akahu API client.
///
/// Use the builder pattern to construct a new client.
pub struct AkahuClient {
    /// HTTP client for making requests
    client: reqwest::Client,
    /// Application ID token
    app_id_token: AppToken,
    /// Optional application secret for app-scoped endpoints
    app_secret: Option<AppSecret>,
    /// Base URL for API requests
    base_url: String,
}

impl AkahuClient {
    /// Create a new Akahu client.
    ///
    /// # Arguments
    ///
    /// * `client` - The HTTP client to use for requests
    /// * `app_id_token` - Your Akahu application ID token
    /// * `base_url` - Optional custom base URL (defaults to `https://api.akahu.io/v1`)
    pub fn new<T: Into<AppToken>>(
        client: reqwest::Client,
        app_id_token: T,
        base_url: Option<String>,
    ) -> Self {
        let base_url = base_url.unwrap_or_else(|| DEFAULT_BASE_URL.to_string());

        Self {
            client,
            app_id_token: app_id_token.into(),
            app_secret: None,
            base_url,
        }
    }

    /// Set the app secret for app-scoped endpoints.
    ///
    /// The app secret is required for app-scoped endpoints like Categories.
    /// These endpoints use HTTP Basic Authentication with app_id_token:app_secret.
    pub fn with_app_secret<T: Into<AppSecret>>(mut self, app_secret: T) -> Self {
        self.app_secret = Some(app_secret.into());
        self
    }
}