The OAuth token endpoint.

TokenResponse

TokenResponse(access_token: str, expires_in: float, refresh_token: str | None = None)

A successful token endpoint response.

Attributes

Name	Type	Description
`access_token`	`str`	The new bearer token; never shown in `repr`.
`expires_in`	`float`	Lifetime of the access token in seconds.
`refresh_token`	`str \| None`	A new refresh token, when the endpoint issues one.

from_json(body: Mapping[str, Any]) -> TokenResponse

Read the snake_case OAuth response body.

TokenEndpoint

TokenEndpoint(settings: OvokSettings)

Ovok's OAuth token endpoint: one plain form POST, without retries or credentials.

Parameters

Name	Type	Default	Description
`settings`	`OvokSettings`		The client's settings.

request(form: Mapping[str, str]) -> TokenResponse

Post form to the token endpoint.

Parameters

Name	Type	Default	Description
`form`	`Mapping[str, str]`		OAuth form fields, such as `grant_type`.

Returns

Raises