Struct Request 

pub struct Request {
    pub method: Method,
    pub path: String,
    pub headers: HashMap<String, String>,
    pub body: Option<RequestBody>,
    pub query: Option<HashMap<String, String>>,
    pub auth: Option<Auth>,
}

HTTP request builder.

Fields

method: Method

HTTP method (GET, POST, etc.)

path: String

Request path (absolute or relative to base_url)

headers: HashMap<String, String>

Request headers

body: Option<RequestBody>

Request body (JSON or bytes)

query: Option<HashMap<String, String>>

Query parameters

auth: Option<Auth>

Authentication override (if None, use client default)

Implementations

impl Request

pub fn get(path: impl Into<String>) -> Self

Creates a new GET request.

pub fn post(path: impl Into<String>) -> Self

Creates a new POST request.

pub fn put(path: impl Into<String>) -> Self

Creates a new PUT request.

pub fn patch(path: impl Into<String>) -> Self

Creates a new PATCH request.

pub fn delete(path: impl Into<String>) -> Self

Creates a new DELETE request.

pub fn head(path: impl Into<String>) -> Self

Creates a new HEAD request.

pub fn new(method: Method, path: impl Into<String>) -> Self

Creates a new request with the given method and path.

pub fn path(self, path: impl Into<String>) -> Self

Sets the request path.

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

Adds a header.

pub fn headers(self, headers: HashMap<String, String>) -> Self

Sets multiple headers.

pub fn body(self, body: RequestBody) -> Self

Sets the request body.

pub fn json_body<T: Serialize>(self, value: &T) -> Result<Self, Error>

Sets the request body from a JSON-serializable value.

pub fn query(self, params: HashMap<String, String>) -> Self

Sets query parameters.

pub fn query_param( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

Adds a query parameter.

pub fn auth(self, auth: Auth) -> Self

Sets authentication for this request (overrides client default).

pub fn bearer_token(self, token: impl Into<String>) -> Self

Sets Bearer token authentication for this request.

pub fn basic_auth( self, username: impl Into<String>, password: impl Into<String>, ) -> Self

Sets Basic authentication for this request.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.