APIKeyQuery

API key authentication using a query parameter. This defines the name of the query parameter that should be provided in the request with the API key and integrates that into the OpenAPI documentation. It extracts the key value sent in the query parameter automatically and provides it as the dependency result. But it doesn't define how to send that API key to the client.

Constructor

Signature

def APIKeyQuery(
    name: str = null,
    scheme_name: str | None = None,
    description: str | None = None,
    auto_error: bool = True
) - > null

Parameters

Name	Type	Description
name	str = null	Query parameter name.
scheme_name	`str	None` = None
description	`str	None` = None
auto_error	bool = True	By default, if the query parameter is not provided, APIKeyQuery will automatically cancel the request and send the client an error. If auto_error is set to False, when the query parameter is not available, instead of erroring out, the dependency result will be None. This is useful when you want to have optional authentication. It is also useful when you want to have authentication that can be provided in one of multiple optional ways (for example, in a query parameter or in an HTTP Bearer token).

---