Struct RequestBuilder 

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

Fluent builder for a single HTTP request.

Implementations

impl<'a> RequestBuilder<'a>

pub fn param(self, key: impl Into<String>, value: impl ToString) -> Self

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

pub fn params_iter( self, params: impl IntoIterator<Item = (impl Into<String>, impl ToString)>, ) -> Self

pub fn query(self, key: impl Into<String>, value: impl ToString) -> Self

pub fn queries(self, query: IndexMap<String, QueryValue>) -> Self

Sets multiple query parameters preserving insertion order.

pub fn query_json<T: Serialize>( self, key: impl Into<String>, value: &T, ) -> Result<Self>

pub fn header( self, key: impl AsRef<str>, value: impl AsRef<str>, ) -> Result<Self>

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

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

pub fn form<I, K, V>(self, fields: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: AsRef<str>, V: AsRef<str>,

URL-encoded form body (application/x-www-form-urlencoded).

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

pub fn retry(self, policy: RetryPolicy) -> Self

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

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

pub fn cancellation_token(self, token: CancellationToken) -> Self

Cancels the in-flight request and retry sleeps when this token is triggered.

pub fn throw_on_error(self, throw: bool) -> Self

When true, send returns Err on non-2xx HTTP status (like upstream throw: true).

pub fn json_parser<F>(self, f: F) -> Self

where F: Fn(&Bytes) -> Result<Value, String> + Send + Sync + 'static,

Overrides the client’s JSON parser for this request only.

See crate::json_parser for fast path vs two-step parsing.

pub fn json_parser_fn(self, parser: JsonParserFn) -> Self

Overrides the client’s JSON parser for this request only.

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

pub async fn send_json<T: DeserializeOwned>(self) -> Result<T>