Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Builds a Client.

Requires either a static token, or both an API key and a secret. Credentials fall back to the VIDEOSDK_API_KEY and VIDEOSDK_SECRET environment variables, and the endpoint to VIDEOSDK_API_ENDPOINT.

let client = videosdk::Client::builder()
    .api_key("my-key")
    .secret("my-secret")
    .max_retries(3)
    .build()?;

Implementations

impl ClientBuilder

pub fn new() -> Self

Starts a new builder.

pub fn api_key(self, api_key: impl Into<String>) -> Self

Sets the project API key. Falls back to VIDEOSDK_API_KEY.

pub fn secret(self, secret: impl Into<String>) -> Self

Sets the project secret. Falls back to VIDEOSDK_SECRET.

pub fn base_url(self, base_url: impl Into<String>) -> Self

Sets the API endpoint. Falls back to VIDEOSDK_API_ENDPOINT, then to DEFAULT_BASE_URL.

pub fn token(self, token: impl Into<String>) -> Self

Uses a pre-generated static token. Disables automatic token refresh unless an API key and secret are also supplied.

pub fn http_client(self, http_client: Client) -> Self

Supplies a preconfigured reqwest::Client, e.g. with a proxy or a custom connection pool.

pub fn max_retries(self, max_retries: u32) -> Self

Sets how many times a failed request is retried. Defaults to 2, giving up to 3 total attempts.

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

Sets the per-request timeout. Defaults to 30 seconds; Duration::ZERO disables it.

This applies to each attempt individually, so a request that exhausts its retries can take longer than this in total.

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

Adds a header sent with every request.

pub fn token_options(self, token_options: TokenOptions) -> Self

Overrides the claims of the tokens the client mints for its own requests.

pub fn backoff( self, backoff: impl Fn(u32) -> Duration + Send + Sync + 'static, ) -> Self

Replaces the retry backoff.

The default is exponential — min(2^attempt seconds, 8s) plus up to 249 ms of jitter — where attempt is the zero-based retry counter.

pub fn build(self) -> Result<Client>

Builds the client, resolving credentials from the environment where they were not set explicitly.

Trait Implementations

impl Default for ClientBuilder

fn default() -> ClientBuilder

Returns the “default value” for a type.