Expand description
The client, its builder, the account-scoped client and the request pipeline they share: hooks, credentials, retries, redirects and the response cache.
Structs§
- Account
Client - A client scoped to one account: every path it sends starts with the account id. Made
with
Client::for_account. - Client
- A Fizzy client: one set of credentials on one origin. Most of the API is scoped to an
account, reached with
Client::for_account; what is not — sessions, identity, access tokens — hangs off the client itself. - Client
Builder - Builds a
Client. - Request
Options - How a raw call is sent, where the defaults are not what the caller wants.
- Response
- What came back from Fizzy, before it is decoded.
- Scope
- What a generated service sends through: the client, and the account when there is one.
Constants§
- DEFAULT_
BASE_ DELAY - The first backoff for a raw call.
- DEFAULT_
MAX_ ATTEMPTS - How many times a raw call is sent, the first attempt included, and the ceiling on what a
modelled route may ask for. Three, as the behavior model gives every retried operation
and as the Go client counts its
MaxRetries. - DEFAULT_
MAX_ DELAY - The longest the client waits between attempts, however many it has made. The backoff’s
job is to stop hammering, and thirty seconds does it; a caller who raised the retry
count would otherwise be waiting minutes on a server that is not coming back. Move it
with
ClientBuilder::max_delay. - DEFAULT_
MAX_ JITTER - The most random time added to a backoff.
- DEFAULT_
MAX_ PAGES - How many pages a walk reads before stopping.
- DEFAULT_
MAX_ RESPONSE_ BODY_ BYTES - The most of an answer the client holds in memory.
- DEFAULT_
MAX_ RETRY_ AFTER - The longest
Retry-Afterthe client sits out. Past it the answer is handed back as the rate-limit error it is, with the wait in the hint, rather than the call blocking for an hour. Move it withClientBuilder::max_retry_after. - DEFAULT_
TIMEOUT - How long the shipped HTTP client gives an answer to arrive.