Struct RequestBuilder 

pub struct RequestBuilder<'a> { /* private fields */ }

A wrapper around middleware::RequestBuilder that provides an ergonomic API and resolves the URL against the client’s base URL.

Implementations

impl<'a> RequestBuilder<'a>

pub fn with_extension<T: Clone + Send + Sync + 'static>(self, value: T) -> Self

Attach request-scoped typed data, carried through every middleware in the chain’s shared extension map (and surviving across retry attempts). Middleware read it with extensions.get::<T>().

pub fn header<K, V>(self, key: K, value: V) -> Self

where HeaderName: TryFrom<K>, <HeaderName as TryFrom<K>>::Error: Into<Error>, HeaderValue: TryFrom<V>, <HeaderValue as TryFrom<V>>::Error: Into<Error>,

Add a single header.

pub fn headers(self, headers: HeaderMap) -> Self

Set all headers from a HeaderMap.

pub fn query<T: Serialize + ?Sized>(self, params: &T) -> Self

Append query parameters.

pub fn timeout(self, timeout: Duration) -> Self

Override the request timeout.

pub fn json<T: Serialize + ?Sized>(self, body: &T) -> Self

Set a JSON body (requires the json feature).

pub fn bearer_auth(self, token: impl Display) -> Self

Set a Bearer authorization token.

pub fn basic_auth( self, username: impl Display, password: Option<impl Display>, ) -> Self

Set HTTP basic auth credentials.

pub fn body(self, body: impl Into<Body>) -> Self

Set the request body directly.

pub fn form<T: Serialize + ?Sized>(self, form: &T) -> Self

Set form-encoded body from a serializable value.

pub async fn send(self) -> Result<Response, FetchError>

Send the request.

pub async fn json_response<T: DeserializeOwned>(self) -> Result<T, FetchError>

Send the request and deserialize the JSON response (requires the json feature).