pub struct RequestBuilder { /* fields omitted */ }
A builder to construct the properties of a Request
.
Add a Header
to this Request.
Add a set of Headers to the existing ones on this Request.
The headers will be merged in to any already set.
Set a header with a type implementing hyper v0.11's Header
trait.
This method is provided to ease migration, and requires the hyper-011
Cargo feature enabled on reqwest
.
Set multiple headers using hyper v0.11's Headers
map.
This method is provided to ease migration, and requires the hyper-011
Cargo feature enabled on reqwest
.
Enable HTTP basic authentication.
pub fn body<T: Into<Body>>(self, body: T) -> RequestBuilder | [src] |
Sends a multipart/form-data body.
let client = reqwest::async::Client::new();
let form = reqwest::async::multipart::Form::new()
.text("key3", "value3")
.text("key4", "value4");
let mut rt = tokio::runtime::current_thread::Runtime::new().expect("new rt");
let response = client.post("your url")
.multipart(form)
.send()
.and_then(|_| {
Ok(())
});
rt.block_on(response)
Modify the query string of the URL.
Modifies the URL of this request, adding the parameters provided.
This method appends and does not overwrite. This means that it can
be called multiple times and that existing query parameters are not
overwritten if the same key is used. The key will simply show up
twice in the query string.
Calling .query([("foo", "a"), ("foo", "b")])
gives "foo=a&foo=b"
.
This method does not support serializing a single key-value
pair. Instead of using .query(("key", "val"))
, use a sequence, such
as .query(&[("key", "val")])
. It's also possible to serialize structs
and maps into a key-value pair.
This method will fail if the object you provide cannot be serialized
into a query string.
Send a JSON body.
Serialization can fail if T
's implementation of Serialize
decides to
fail, or if T
contains a map with non-string keys.
Build a Request
, which can be inspected, modified and executed with
Client::execute()
.
Constructs the Request and sends it the target URL, returning a Response.
This method fails if there was an error while sending request,
redirect loop was detected or redirect limit was exhausted.
Formats the value using the given formatter. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static