Struct Request 

pub struct Request { /* private fields */ }

An HTTP request builder and executor with base URL and default headers.

Implementations

impl Request

pub fn new() -> Result<Self>

Create a new Request client.

pub fn with_timeout(timeout_sec: u64) -> Result<Self>

pub fn set_base_url(&mut self, base_url: &str) -> Result<()>

Set the base URL for all requests.

pub fn set_default_headers(&mut self, headers: HeaderMap)

Set default headers to be applied on all requests.

pub async fn get( &self, endpoint: &str, query: Option<Vec<(String, String)>>, headers: Option<HeaderMap>, ) -> Result<Response>

Send a GET request.

pub async fn post( &self, endpoint: &str, body: &Value, headers: Option<HeaderMap>, ) -> Result<Response>

Send a POST request with JSON body.

pub async fn put( &self, endpoint: &str, body: &Value, headers: Option<HeaderMap>, ) -> Result<Response>

Send a PUT request with JSON body.

pub async fn delete( &self, endpoint: &str, headers: Option<HeaderMap>, ) -> Result<Response>

Send a DELETE request.

pub async fn post_form( &self, endpoint: &str, form_fields: Vec<FormField>, headers: Option<HeaderMap>, ) -> Result<Response>

Send a POST request with multipart/form-data.

Arguments

• endpoint - The URL endpoint
• form_fields - Vector of form fields (text or file)
• headers - Optional custom headers

Important

The Content-Type header will be automatically removed from default and custom headers to allow reqwest to set the correct multipart/form-data with boundary.

Example

use toolcraft_request::{FormField, Request};

let client = Request::new()?;
let fields = vec![
    FormField::text("name", "John"),
    FormField::file("avatar", "/path/to/image.jpg").await?,
];
let response = client.post_form("/upload", fields, None).await?;

pub async fn post_stream( &self, endpoint: &str, body: &Value, headers: Option<HeaderMap>, ) -> Result<ByteStream>

Send a streaming POST request and return the response stream.

Trait Implementations

impl Debug for Request

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

Formats the value using the given formatter.