Struct ClientConfig 

pub struct ClientConfig {
    pub base_url: String,
    pub api_key: Secret<String>,
    pub timeout: Duration,
    pub user_agent: String,
    pub retry: RetryPolicy,
}

Shared configuration consumed by both the async and blocking clients.

The API key is wrapped in a Secret so it can never be logged or serialized in cleartext. The derived Debug is safe: it prints api_key: [REDACTED].

Fields

base_url: String

API base URL, without a trailing slash. Defaults to DEFAULT_BASE_URL.

api_key: Secret<String>

Bearer API key.

timeout: Duration

Per-request timeout. Defaults to 30 seconds.

user_agent: String

User-Agent header value.

retry: RetryPolicy

How transient failures are retried. Defaults to RetryPolicy::default (up to two retries with jittered exponential backoff).

Implementations

impl ClientConfig

pub fn new(api_key: impl Into<Secret<String>>) -> Self

Create a configuration from an API key, using production defaults.

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

Override the base URL (trailing slashes are trimmed).

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

Override the per-request timeout.

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

Override the User-Agent header.

pub fn with_retry(self, retry: RetryPolicy) -> Self

Override the retry policy. Pass RetryPolicy::none to disable retries.

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClientConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.