Struct RequestBuilder

pub struct RequestBuilder { /* private fields */ }

Implementations

impl RequestBuilder

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

where K: Into<FieldKey>, V: Into<FieldValue>,

Add a header to the Request.

let resp = Client::new().get("https://httpbin.org/get")
    .header("Content-Type", "application/json")
    .send()?;

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

where K: Into<FieldKey>, V: Into<FieldValue>, I: IntoIterator<Item = (K, V)>,

Add a set of headers to the Request.

Existing headers will be overwritten.

let resp = Client::new().get("https://httpbin.org/get")
    .headers([("Content-Type", "application/json"), ("Accept", "*/*")])
    .send()?;

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

Modify the query string of the Request URL.

let resp = Client::new().get("https://httpbin.org/get")
    .query(&[("a", "b"), ("c", "d")])
    .send()?;

pub fn body(self, body: &[u8]) -> Self

Set the request body.

let resp = Client::new().post("https://httpbin.org/post")
    .body("hello".as_bytes())
    .send()?;

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

Available on crate feature json only.

Send a JSON body.

Optional

This requires the json feature enabled.

let resp = Client::new().post("https://httpbin.org/post")
    .json(&HashMap::from([("data", "hello")]))
    .send()?;

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

Send a form body.

let resp = Client::new().post("https://httpbin.org/post")
    .form(&[("a", "b"), ("c", "d")])
    .send()?;

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

Set the timeout for the initial connect to the HTTP Server.

let resp = Client::new().post("https://httpbin.org/post")
    .connect_timeout(Duration::from_secs(5))
    .send()?;

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

Send the Request, returning a Response.