Struct Request 

pub struct Request { /* private fields */ }

An HTTP request.

Construct with Request::new and configure using the builder methods.

Implementations

impl Request

pub fn new(url: impl Into<String>, verb: impl Into<String>) -> Self

Create a new request with no body and no authorization.

Examples

---

Build a GET request:

use momento_functions_http::Request;

let request = Request::new("https://example.com/api", "GET");

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

Add a header to the request.

pub fn with_headers<K, V>( self, headers: impl IntoIterator<Item = (K, V)>, ) -> Self

where K: Into<String>, V: Into<String>,

Add multiple headers to the request at once.

Examples

---

use momento_functions_http::Request;

let request = Request::new("https://example.com/api", "POST")
    .with_headers([
        ("Content-Type", "application/json"),
        ("Accept", "application/json"),
    ]);

pub fn json<T: Serialize>(self, body: Json<T>) -> Result<Self, Error>

Set the request body to a JSON-serialized value, and set the content-type header to application/json.

Examples

---

use momento_functions_http::Request;
use momento_functions_bytes::encoding::Json;

#[derive(serde::Serialize)]
struct Payload { message: String }

let request = match Request::new("https://example.com/api", "POST")
    .json(Json(Payload { message: "hello".to_string() }))
{
    Ok(request) => request,
    Err(e) => {
        eprintln!("failed to serialize body: {e}");
        return;
    }
};

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

Set the request body.

pub fn with_authorization(self, authorization: Authorization) -> Self

Set the authorization strategy.