Struct ClientConfig 

pub struct ClientConfig {
    pub base_url: String,
    pub api_key: String,
    pub management_token: String,
    pub delivery_token: String,
    pub environment: Option<String>,
    pub timeout: Duration,
    pub max_connections: usize,
    pub region: Region,
}

Finalized configuration used by Contentstack clients.

This struct is typically constructed using ClientConfig::delivery or ClientConfig::management.

Fields

base_url: String

The base URL used for API requests.

api_key: String

Your Contentstack stack API key.

management_token: String

The token used for Management API authentication.

delivery_token: String

The token used for Delivery API authentication.

environment: Option<String>

The publishing environment (e.g., “production”). Only used by the Delivery API.

timeout: Duration

The maximum duration to wait for a request to complete.

max_connections: usize

The maximum number of concurrent connections allowed in the pool.

region: Region

The geographical region for the API.

Implementations

impl ClientConfig

pub fn delivery( api_key: &str, delivery_token: &str, environment: &str, opts: Option<ClientOptions>, ) -> Self

Builds a ClientConfig configured for the Contentstack Delivery API.

Initializes a configuration object using the provided API key, delivery token, and environment. If opts is None, default settings are applied (AWS NA region, 30-second timeout, 50 max connections).

Arguments

• api_key - Your stack’s API key
• delivery_token - Your stack’s delivery token (read-only)
• environment - The name of the publishing environment
• opts - Optional configuration overrides (ClientOptions)

Examples

use contentstack_api_client_rs::client::config::ClientConfig;

let config = ClientConfig::delivery("api_key", "delivery_token", "production", None);
assert_eq!(config.environment.as_deref(), Some("production"));

pub fn management( api_key: &str, management_token: &str, opts: Option<ClientOptions>, ) -> Self

Builds a ClientConfig for the Management API.

Defaults to AWS NA region (https://api.contentstack.io) if no base_url or region override is provided. Management API requests do not use an environment, so that field is left empty.

Arguments

• api_key - Your stack’s API key
• management_token - Stack management token
• opts - Optional configuration overrides (region, timeout, max connections)

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.