Struct mangadex_api::HttpClient

pub struct HttpClient {
    pub client: Client,
    pub base_url: Url,
    auth_tokens: Option<AuthTokens>,
    captcha: Option<String>,
}

Fields

client: Client

base_url: Url

auth_tokens: Option<AuthTokens>

captcha: Option<String>

Implementations

impl HttpClient

pub fn new(client: Client) -> Self

Create a new HttpClient with a custom reqwest::Client.

pub fn builder() -> HttpClientBuilder

Get a builder struct to customize the HttpClient fields.

Examples

use url::Url;

use mangadex_api::{MangaDexClient, HttpClient};

let http_client = HttpClient::builder()
    .base_url(Url::parse("127.0.0.1:8000")?)
    .build()?;

let mangadex_client = MangaDexClient::new_with_http_client(http_client);

pub(crate) async fn send_request_without_deserializing<E>(
    &self,
    endpoint: &E
) -> Result<Response> where
    E: Endpoint, 

Send the request to the endpoint but don’t deserialize the response.

This is useful to handle things such as response header data for more control over areas such as rate limiting.

pub(crate) async fn send_request<E>(&self, endpoint: &E) -> Result<E::Response> where
    E: Endpoint,
    <<E as Endpoint>::Response as FromResponse>::Response: DeserializeOwned, 

Send the request to the endpoint and deserialize the response body.

pub fn get_tokens(&self) -> Option<&AuthTokens>

Get the authentication tokens stored in the client.

pub fn set_auth_tokens(&mut self, auth_tokens: &AuthTokens)

Set new authentication tokens into the client.

pub fn clear_auth_tokens(&mut self)

Remove all authentication tokens from the client.

This is effectively the same as logging out, though will not remove the active session from the MangaDex server. Be sure to call the logout endpoint to ensure your session is removed.

pub fn get_captcha(&self) -> Option<&String>

Get the captcha solution stored in the client.

pub fn set_captcha<T: Into<String>>(&mut self, captcha: T)

Set a new captcha solution into the client.

The code needed for this can be found in the “X-Captcha-Sitekey” header field, or the siteKey parameter in the error context of a 403 response, captcha_required_exception error code.

pub fn clear_captcha(&mut self)

Remove the captcha solution from the client.

Trait Implementations

impl Clone for HttpClient

fn clone(&self) -> HttpClient

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HttpClient

fn default() -> Self

Returns the “default value” for a type.