Struct reqwest::RequestBuilder [−][src]
pub struct RequestBuilder { /* fields omitted */ }
Expand description
A builder to construct the properties of a Request
.
Implementations
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"
.
Note
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.
Errors
This method will fail if the object you provide cannot be serialized into a query string.
This is supported on crate feature json
only.
json
only.Set the request json
Enable HTTP bearer authentication.
Set the request body.
This is supported on crate feature multipart
only.
multipart
only.TODO
pub fn header<K, V>(self, key: K, value: V) -> RequestBuilder where
HeaderName: TryFrom<K>,
<HeaderName as TryFrom<K>>::Error: Into<Error>,
HeaderValue: TryFrom<V>,
<HeaderValue as TryFrom<V>>::Error: Into<Error>,
pub fn header<K, V>(self, key: K, value: V) -> RequestBuilder where
HeaderName: TryFrom<K>,
<HeaderName as TryFrom<K>>::Error: Into<Error>,
HeaderValue: TryFrom<V>,
<HeaderValue as TryFrom<V>>::Error: Into<Error>,
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.
Disable CORS on fetching the request.
WASM
This option is only effective with WebAssembly target.
The request mode will be set to ‘no-cors’.
Set fetch credentials to ‘same-origin’
WASM
This option is only effective with WebAssembly target.
The request credentials will be set to ‘same-origin’.
Set fetch credentials to ‘include’
WASM
This option is only effective with WebAssembly target.
The request credentials will be set to ‘include’.
Set fetch credentials to ‘omit’
WASM
This option is only effective with WebAssembly target.
The request credentials will be set to ‘omit’.
Build a Request
, which can be inspected, modified and executed with
Client::execute()
.
Attempt to clone the RequestBuilder.
None
is returned if the RequestBuilder can not be cloned. This method
currently always returns Some
, but that may change in the future.
Examples
let client = reqwest::Client::new(); let builder = client.post("http://httpbin.org/post") .body("from a &str!"); let clone = builder.try_clone(); assert!(clone.is_some());
Trait Implementations
Auto Trait Implementations
impl !RefUnwindSafe for RequestBuilder
impl Send for RequestBuilder
impl Sync for RequestBuilder
impl Unpin for RequestBuilder
impl !UnwindSafe for RequestBuilder