Struct RequestBuilder 

pub struct RequestBuilder { /* private fields */ }

A request under construction. Finish it with send.

Implementations

impl RequestBuilder

pub fn header(self, name: &str, value: &str) -> Self

Set a header, replacing any previous value.

pub fn bearer(self, token: &str) -> Self

Set Authorization: Bearer <token>.

pub fn query<T: Serialize>(self, pairs: &T) -> Self

Append a query string built from pairs.

Existing query parameters on the URL are kept; these are added after them.

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

Send body verbatim, with no Content-Type of its own.

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

Serialize value as JSON and set Content-Type: application/json.

pub fn form<T: Serialize>(self, value: &T) -> Self

Serialize value as a URL-encoded form body.

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

Override the client’s timeout for this request only.

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

Send the request and read the whole response.

Errors

Any ClientError. A non-2xx status is not an error: it is a response, and whether a 404 is a failure is the caller’s judgement. Use Response::error_for_status to opt into the other convention.

Trait Implementations

impl Debug for RequestBuilder

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

Formats the value using the given formatter.