Struct HttpClient

pub struct HttpClient { /* private fields */ }

HTTP client for TACT protocol

Implementations

impl HttpClient

pub fn new(region: Region, version: ProtocolVersion) -> Result<Self>

Create a new HTTP client for the specified region and protocol version

pub fn with_shared_pool(region: Region, version: ProtocolVersion) -> Self

Create a new HTTP client using the global connection pool

This provides better performance than new() by reusing connections across multiple HttpClient instances. Recommended for production use.

pub fn with_client( client: Client, region: Region, version: ProtocolVersion, ) -> Self

Create a new HTTP client with custom reqwest client

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

Set the maximum number of retries for failed requests

Default is 0 (no retries) to maintain backward compatibility. Only network and connection errors are retried, not parsing errors.

pub fn with_initial_backoff_ms(self, initial_backoff_ms: u64) -> Self

Set the initial backoff duration in milliseconds

Default is 100ms. This is the base delay before the first retry.

pub fn with_max_backoff_ms(self, max_backoff_ms: u64) -> Self

Set the maximum backoff duration in milliseconds

Default is 10,000ms (10 seconds). Backoff will not exceed this value.

pub fn with_backoff_multiplier(self, backoff_multiplier: f64) -> Self

Set the backoff multiplier

Default is 2.0. The backoff duration is multiplied by this value after each retry.

pub fn with_jitter_factor(self, jitter_factor: f64) -> Self

Set the jitter factor (0.0 to 1.0)

Default is 0.1 (10% jitter). Adds randomness to prevent thundering herd.

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

Set a custom user agent string

If not set, reqwest’s default user agent will be used.

pub fn base_url(&self) -> String

Get the base URL for the current configuration

pub fn region(&self) -> Region

Get the current region

pub fn version(&self) -> ProtocolVersion

Get the current protocol version

pub fn set_region(&mut self, region: Region)

Set the region

pub async fn get_versions(&self, product: &str) -> Result<Response>

Get versions manifest for a product (V1 protocol)

pub async fn get_cdns(&self, product: &str) -> Result<Response>

Get CDN configuration for a product (V1 protocol)

pub async fn get_bgdl(&self, product: &str) -> Result<Response>

Get BGDL manifest for a product (V1 protocol)

pub async fn get_summary(&self) -> Result<Response>

Get product summary (V2 protocol)

pub async fn get_product(&self, product: &str) -> Result<Response>

Get product details (V2 protocol)

pub async fn get_product_versions_http(&self, product: &str) -> Result<Response>

Get product versions using modern HTTP endpoint (V2 protocol) Uses the primary endpoint: https://us.version.battle.net/wow/versions

pub async fn get_product_cdns_http(&self, product: &str) -> Result<Response>

Get CDN information using modern HTTP endpoint (V2 protocol) Uses the primary endpoint: https://us.version.battle.net/wow/cdns

pub async fn get(&self, path: &str) -> Result<Response>

Make a raw GET request to a path

pub async fn download_file( &self, cdn_host: &str, path: &str, hash: &str, ) -> Result<Response>

Download a file from CDN

pub async fn download_file_range( &self, cdn_host: &str, path: &str, hash: &str, range: (u64, Option<u64>), ) -> Result<Response>

Download a file from CDN with HTTP range request for partial content

Arguments

• cdn_host - CDN hostname
• path - Path prefix for the CDN
• hash - File hash
• range - Byte range to download (e.g., (0, Some(1023)) for first 1024 bytes)

Returns

Returns a response with the requested byte range. The response will have status 206 (Partial Content) if the range is supported, or status 200 (OK) with full content if range requests are not supported.

pub async fn download_file_multirange( &self, cdn_host: &str, path: &str, hash: &str, ranges: &[(u64, Option<u64>)], ) -> Result<Response>

Download multiple ranges from a file in a single request

Arguments

• cdn_host - CDN hostname
• path - Path prefix for the CDN
• hash - File hash
• ranges - Multiple byte ranges to download

Note

Multi-range requests return multipart/byteranges content type that needs special parsing. Use with caution - not all CDN servers support this.

pub async fn get_versions_parsed( &self, product: &str, ) -> Result<Vec<VersionEntry>>

Get parsed versions manifest for a product

pub async fn get_cdns_parsed(&self, product: &str) -> Result<Vec<CdnEntry>>

Get parsed CDN manifest for a product

pub async fn get_product_versions_http_parsed( &self, product: &str, ) -> Result<Vec<VersionEntry>>

Get parsed product versions using modern HTTP endpoint

pub async fn get_product_cdns_http_parsed( &self, product: &str, ) -> Result<Vec<CdnEntry>>

Get parsed CDN configuration using modern HTTP endpoint

pub async fn get_bgdl_parsed(&self, product: &str) -> Result<Vec<BgdlEntry>>

Get parsed BGDL manifest for a product

Trait Implementations

impl Clone for HttpClient

fn clone(&self) -> HttpClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpClient

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

Formats the value using the given formatter.

impl Default for HttpClient

fn default() -> Self

Returns the “default value” for a type.