Struct ApiClient

pub struct ApiClient {
    pub http: Client,
    pub state: ApiClientState,
    pub host: String,
}

The API client is used to manage authentication flow and send requests on behalf of a user.

This client assumes you already have the required information for the given user. If you don’t, try using the JS SDK to extract this information.

Fields

http: Client

The HTTP client associated with this client.

state: ApiClientState

The general state of the client. Will be updated whenever you refresh the user’s token.

host: String

The origin of the Tetratto server. When creating with ApiClient::new, you can provide None to use https://tetratto.com.

Implementations

impl ApiClient

pub fn new(host: Option<String>, state: ApiClientState) -> Self

Create a new ApiClient.

pub async fn refresh_token(&mut self) -> Result<String>

Refresh the client’s user_token.

pub async fn request<T, B>( &self, route: String, method: Method, body: Option<&B>, ) -> Result<ApiReturn<T>>

where T: Serialize + DeserializeOwned, B: Serialize + ?Sized,

Send a simple JSON request to the given endpoint.

pub async fn request_attachments<T, B>( &self, route: String, attachments: Vec<Vec<u8>>, body: &B, ) -> Result<ApiReturn<T>>

where T: Serialize + DeserializeOwned, B: Serialize + ?Sized,

Send a JSON request with attachments to the given endpoint.

This type of request is only required for routes which use JsonMultipart, such as POST /api/v1/posts (create_post).

Method is locked to POST for this type of request.

Trait Implementations

impl Clone for ApiClient

fn clone(&self) -> ApiClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ApiClient

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

Formats the value using the given formatter.