Struct BetfairHttpClient 

pub struct BetfairHttpClient { /* private fields */ }

Betfair HTTP client for raw API operations.

Handles session-token authentication, JSON-RPC protocol, form-encoded identity requests, REST navigation, rate limiting, and retry logic.

Implementations

impl BetfairHttpClient

pub fn new( credential: BetfairCredential, timeout_secs: Option<u64>, max_retries: Option<u32>, retry_delay_ms: Option<u64>, proxy_url: Option<String>, request_rate_per_second: Option<u32>, order_request_rate_per_second: Option<u32>, ) -> Result<Self, BetfairHttpError>

Creates a new BetfairHttpClient.

Errors

Returns an error if the HTTP client cannot be created.

pub fn with_urls( self, identity_login: String, betting: String, accounts: String, navigation: String, ) -> Self

Overrides the API base URLs (for testing with mock servers).

The keep-alive URL is derived from identity_login by replacing the path with /keepAlive.

pub fn cancellation_token(&self) -> &CancellationToken

Returns the cancellation token for this client.

pub async fn session_token(&self) -> Option<String>

Returns the current session token, if authenticated.

pub async fn is_connected(&self) -> bool

Returns whether the client has an active session.

pub fn app_key(&self) -> &str

Returns the application key.

pub async fn connect(&self) -> Result<(), BetfairHttpError>

Authenticates with Betfair using interactive (non-cert) login.

Sends credentials to the Identity API and stores the returned session token for subsequent requests.

Errors

Returns an error if the login request fails or authentication is rejected.

pub async fn reconnect(&self) -> Result<(), BetfairHttpError>

Resets the session and re-authenticates.

Errors

Returns an error if re-authentication fails.

pub async fn disconnect(&self)

Clears the session token.

pub async fn keep_alive(&self) -> Result<(), BetfairHttpError>

Sends a keep-alive request to renew the session.

Errors

Returns an error if the keep-alive request fails.

pub async fn send_betting<T, P>( &self, method: &str, params: P, ) -> Result<T, BetfairHttpError>

where T: DeserializeOwned, P: Serialize,

Sends a JSON-RPC request to the Betting API.

Errors

Returns an error if the request fails, authentication is missing, or the response contains a JSON-RPC error.

pub async fn send_betting_order<T, P>( &self, method: &str, params: P, ) -> Result<T, BetfairHttpError>

where T: DeserializeOwned, P: Serialize,

Sends a JSON-RPC request to the Betting API with order rate limiting.

Errors

Returns an error if the request fails, authentication is missing, or the response contains a JSON-RPC error.

pub async fn send_accounts<T, P>( &self, method: &str, params: P, ) -> Result<T, BetfairHttpError>

where T: DeserializeOwned, P: Serialize,

Sends a JSON-RPC request to the Accounts API.

Errors

Returns an error if the request fails, authentication is missing, or the response contains a JSON-RPC error.

pub async fn send_navigation<T>(&self) -> Result<T, BetfairHttpError>

where T: DeserializeOwned,

Sends a GET request to the Navigation API.

Errors

Returns an error if the request fails or the response cannot be parsed.

Trait Implementations

impl Debug for BetfairHttpClient

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

Formats the value using the given formatter.