Struct Request 

pub struct Request { /* private fields */ }

A request being built; send it with Request::send.

Implementations

impl Request

pub fn query(self, pairs: &[(&str, &str)]) -> Self

Adds query parameters (encoded).

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

Adds a header (repeatable: a name may be sent more than once).

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

Authorization: Bearer <token>.

pub fn basic_auth(self, user: &str, password: &str) -> Self

Authorization: Basic ….

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

A JSON body (Content-Type: application/json).

pub fn form(self, body: &impl Serialize) -> Self

A form body (application/x-www-form-urlencoded).

pub fn body(self, content_type: &str, body: impl Into<Vec<u8>>) -> Self

A raw body with its content type.

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

How long one attempt may take (30 s by default).

pub fn retry(self, times: u32, delay: Duration) -> Self

Tries again up to times more times after a connection error, a timeout, a 429 or a 5xx, waiting delay, then twice that, and so on.

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

Sends the request (with its retries) and reads the whole response. Any status is a response; see Response::error_for_status.