Struct MoltbookClient 

pub struct MoltbookClient { /* private fields */ }

A thread-safe, asynchronous client for the Moltbook API.

Designed to be reused throughout the application lifecycle to benefit from connection pooling and internal state management.

Implementations

impl MoltbookClient

pub fn new(api_key: String, debug: bool) -> Self

Creates a new MoltbookClient instance.

Arguments

• api_key - The API key for authentication.
• debug - If true, logs all requests and responses to stderr.

pub async fn get<T: DeserializeOwned>( &self, endpoint: &str, ) -> Result<T, ApiError>

Performs a GET request to the specified endpoint.

Errors

Returns ApiError if the network fails, the API returns an error, or parsing fails.

pub async fn post<T: DeserializeOwned>( &self, endpoint: &str, body: &impl Serialize, ) -> Result<T, ApiError>

Performs a POST request with a JSON body.

Errors

Returns ApiError if the network fails, the API returns an error, or serialization/parsing fails.

pub async fn post_file<T: DeserializeOwned>( &self, endpoint: &str, file_path: PathBuf, ) -> Result<T, ApiError>

Uploads a file using multipart/form-data.

Typically used for avatar updates.

Errors

Returns ApiError if the file cannot be read or the upload fails.

pub async fn patch<T: DeserializeOwned>( &self, endpoint: &str, body: &impl Serialize, ) -> Result<T, ApiError>

Performs a PATCH request with a JSON body.

pub async fn delete<T: DeserializeOwned>( &self, endpoint: &str, ) -> Result<T, ApiError>

Performs a DELETE request to the specified endpoint.