Struct HttpClient 

pub struct HttpClient { /* private fields */ }

Low-level HTTP transport for the Apify API.

You usually do not interact with this directly — ApifyClient owns an HttpClient and passes references to the resource clients.

Responsibilities:

• Base-URL + path concatenation.
• Bearer-token authentication.
• JSON body serialization / deserialization.
• Translating HTTP errors into ApifyError.
• Exponential-backoff retries for 429 Too Many Requests.

Implementations

impl HttpClient

pub fn new(token: Option<String>) -> Self

Construct a new HTTP client.

token is optional — pass None for anonymous (read-only) access.

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

Override the base URL used for every request.

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

Re-build the underlying reqwest::Client with a custom timeout.

pub async fn request<T: DeserializeOwned>( &self, method: Method, path: &str, body: Option<impl Serialize>, ) -> Result<T, ApifyError>

Send a request and deserialize the JSON body into T.

path is relative to the base URL (e.g. /actor-tasks). Authentication and JSON Content-Type are handled automatically.

pub async fn request_with_retry<T: DeserializeOwned>( &self, method: Method, path: &str, body: Option<impl Serialize>, ) -> Result<T, ApifyError>

Send a request with exponential-backoff retries on 429 responses.

Starts with a 500 ms delay and doubles it up to 5 attempts. Use this for idempotent reads when you expect bursts of traffic.

impl HttpClient

Convenience helpers that unwrap Apify’s { "data": ... } envelope.

pub async fn get_data<T: DeserializeOwned>( &self, path: &str, ) -> Result<T, ApifyError>

GET a single resource and return the inner data field.

pub async fn post_data<T: DeserializeOwned, B: Serialize>( &self, path: &str, body: B, ) -> Result<T, ApifyError>

POST a JSON body and return the inner data field of the response.

pub async fn put_data<T: DeserializeOwned, B: Serialize>( &self, path: &str, body: B, ) -> Result<T, ApifyError>

PUT a JSON body and return the inner data field of the response.

pub async fn delete_request(&self, path: &str) -> Result<(), ApifyError>

DELETE a resource, returning () on success.

pub async fn get_list<T: DeserializeOwned>( &self, path: &str, ) -> Result<ListData<T>, ApifyError>

GET a paginated list and return the inner ListData.

Trait Implementations

impl Clone for HttpClient

fn clone(&self) -> Self

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.