Struct RequestBuilder 

pub struct RequestBuilder { /* private fields */ }

Fluent outbound request builder produced by Client methods.

Implementations

impl RequestBuilder

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

Append a request header.

Headers named authorization, cookie, or set-cookie are accepted normally but are redacted in tracing events and log output. Invalid header names or values emit a tracing::warn! and are skipped.

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

Serialise body as JSON and set Content-Type: application/json.

Serialisation errors are captured and returned when send is called rather than being silently discarded.

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

Set a plain-text body.

pub const fn retries(self, max: u32) -> Self

Override the maximum retry count for this request.

Also clears the idempotent-only flag so non-idempotent methods such as POST and PATCH are retried when the caller explicitly requests it.

pub const fn max_retry_after(self, max: Duration) -> Self

Override the maximum Retry-After sleep duration for this request.

pub const fn no_retry(self) -> Self

Disable retries for this request.

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

Send the request, applying retries and returning a Response.

Errors

Returns ClientError::Json if a prior .json() call failed to serialise the body. Returns ClientError::Request for transport errors that exhaust all retry attempts. Returns ClientError::NoMock if the request is made in a test context without a matching mock entry.

Panics

Contains an internal unreachable!() that guards against a logic error in the retry loop; it cannot be reached in practice.