eve_esi 0.4.9

Thread-safe, asynchronous client for EVE Online's ESI & OAuth2
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

//! # EVE ESI Public Request Methods
//!
//! Provides the underlying utility methods used to make requests to
//! ESI routes.
//!
//! See the [module-level documentation](super) for an overview, methods, & usage example.
//!
//! ## Methods
//! - [`EsiApi::get_from_public_esi`]: Makes an unauthenticated GET request to the ESI API.
//! - [`EsiApi::post_to_public_esi`]: Makes an unauthenticated POST request to the ESI API.

use serde::{de::DeserializeOwned, Serialize};

use super::EsiApi;
use crate::Error;

impl<'a> EsiApi<'a> {
    /// Makes an unauthenticated GET request to the ESI API.
    ///
    /// See the [module-level documentation](super) for an overview, methods, & usage example.
    ///
    /// # Arguments
    /// - `url` (`&str`): The ESI API endpoint URL to request.
    ///
    /// # Returns
    /// A Result containing the deserialized response data or a reqwest error.
    ///
    /// # Type Parameters
    /// - `T` - The expected return type that implements `DeserializeOwned`
    pub async fn get_from_public_esi<T: DeserializeOwned>(&self, url: &str) -> Result<T, Error> {
        let reqwest_client = &self.client.inner.reqwest_client;

        let req = reqwest_client.get(url).send().await?;
        req.error_for_status_ref()?;
        let result: T = req.json().await?;
        Ok(result)
    }

    /// Makes an unauthenticated POST request to the ESI API.
    ///
    /// See the [module-level documentation](super) for an overview, methods, & usage example.
    ///
    /// # Arguments
    /// - `url` (`&str`):  The ESI API endpoint URL to request.
    /// - `data` ([`Serialize`]): The data to send in the request body.
    ///
    /// # Returns
    /// A Result containing the deserialized response data or a reqwest error.
    ///
    /// # Type Parameters
    /// - `T` - The expected return type that implements `DeserializeOwned`.
    /// - `U` - The type of data to send, which must implement `Serialize`.
    pub async fn post_to_public_esi<T: DeserializeOwned, U: Serialize + ?Sized>(
        &self,
        url: &str,
        data: &U,
    ) -> Result<T, Error> {
        let reqwest_client = &self.client.inner.reqwest_client;

        let req = reqwest_client.post(url).json(data).send().await?;
        req.error_for_status_ref()?;
        let result: T = req.json().await?;
        Ok(result)
    }
}