Struct SignedRequestBuilder 

pub struct SignedRequestBuilder<'a, E, S>
where
    E: HasHttpClient,
    S: SigningStrategy,
{ /* private fields */ }

Generic builder for creating authenticated API requests.

This builder encapsulates the common workflow:

1. Parameter building with fluent API
2. Request signing via SigningStrategy
3. HTTP execution via HasHttpClient

Implementations

impl<'a, E, S> SignedRequestBuilder<'a, E, S>

where E: HasHttpClient, S: SigningStrategy,

pub fn new(exchange: &'a E, strategy: S, endpoint: impl Into<String>) -> Self

Create a new signed request builder.

pub fn method(self, method: HttpMethod) -> Self

Set the HTTP method (default: GET).

pub fn param(self, key: impl Into<String>, value: &dyn ToString) -> Self

Add a required parameter.

pub fn optional_param<T: ToString>( self, key: impl Into<String>, value: Option<T>, ) -> Self

Add an optional parameter (only if Some).

pub fn params(self, params: BTreeMap<String, String>) -> Self

Add multiple parameters from a BTreeMap.

pub fn body(self, body: Value) -> Self

Set the request body (for POST/PUT/DELETE).

pub fn merge_json_params(self, params: Option<Value>) -> Self

Merge parameters from a JSON Value object.

Only string, number, and boolean values are supported. Nested objects and arrays are ignored.

pub async fn execute(self) -> Result<Value>

Execute the signed request.

Steps

1. Create SigningContext from builder state
2. Call strategy.prepare_request() to sign
3. Build headers via strategy.add_auth_headers()
4. Execute HTTP request via exchange.http_client()