sure-client-rs 0.4.3

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
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
95
96
97
98
99

use thiserror::Error;

/// The main error type for the Sure API client
#[derive(Debug, Error)]
pub enum ApiError {
    // API-level errors
    /// Bad request error (400)
    #[error("Bad request: {message} (status: {status})")]
    BadRequest {
        /// The error message from the API
        message: String,
        /// The HTTP status code
        status: reqwest::StatusCode,
    },

    /// Unauthorized error (401)
    #[error("Unauthorized: {message}")]
    Unauthorized {
        /// The error message from the API
        message: String,
    },

    /// Forbidden error (403)
    #[error("Forbidden: {message}")]
    Forbidden {
        /// The error message from the API
        message: String,
    },

    /// Not found error (404)
    #[error("Not found: {message}")]
    NotFound {
        /// The error message from the API
        message: String,
    },

    /// Unprocessable entity error (422)
    #[error("Validation error: {message}")]
    ValidationError {
        /// The error message from the API
        message: String,
    },

    /// Rate limit error (429)
    #[error("Rate limited: {message}")]
    RateLimited {
        /// The error message from the API
        message: String,
    },

    /// Internal server error (500)
    #[error("Internal server error: {message}")]
    InternalServerError {
        /// The error message from the API
        message: String,
    },

    /// Generic API error
    #[error("API error {status}: {message}")]
    ApiError {
        /// The HTTP status code
        status: reqwest::StatusCode,
        /// The error message from the API
        message: String,
    },

    // Client-level errors
    /// Invalid parameter error (client-side validation)
    #[error("Invalid parameter: {0}")]
    InvalidParameter(String),

    /// Network error
    #[error("Network error: {0}")]
    Network(#[from] reqwest::Error),

    /// Invalid header value
    #[error("Invalid header value: {0}")]
    InvalidHeaderValue(#[from] reqwest::header::InvalidHeaderValue),

    /// URL parse error
    #[error("URL parse error: {0}")]
    UrlParse(#[from] url::ParseError),

    /// JSON deserialization error
    #[error("JSON deserialization error: {error}. Source: {source_string}")]
    JsonDeserialization {
        /// The underlying serde error
        error: serde_json::Error,
        /// The source string that failed to deserialize
        source_string: String,
    },

    /// JSON serialization error
    #[error("JSON serialization error: {0}")]
    JsonSerialization(#[from] serde_json::Error),
}

/// Result type alias for the Sure API client
pub type ApiResult<T> = std::result::Result<T, ApiError>;