Reference

Look up the terms, parameters, and specifications used in the lessons.

Terminology

Authorization grant
A credential representing authorization that a client can use to obtain an access token. The authorization code is one type of grant.
Authorization endpoint
The endpoint the browser visits to request authorization from the resource owner.
Token endpoint
The endpoint a client contacts directly to obtain or refresh tokens.
Redirect URI
The registered client callback destination where the browser delivers the authorization result to the client.
Scope
A value that describes requested or granted access. Its meaning is defined by the authorization server and resource policy.
Audience
The intended recipient of a token. An API checks that an access token is intended for it.
Issuer
The authority that issued the token or authentication result.
Bearer token
A token that can be used by whoever holds it. The recipient checks the token and its authorization.
Introspection
An authenticated request to learn whether a token is active and obtain applicable metadata.
PKCE
Proof Key for Code Exchange. A client commits to a fresh verifier using a challenge and presents the verifier when redeeming the code.

Authorization Code + PKCE parameters

response_type=code
Requests an authorization code at the authorization endpoint.
state
Client-generated value returned in the authorization response. The client can use it to bind the callback to the initiating browser session.
code_challenge, code_challenge_method=S256
The verifier commitment and its transformation, sent through the browser.
grant_type=authorization_code, code_verifier
The grant type and the original verifier in the token request body.

Bearer token request

GET /v1/saved-books HTTP/1.1
Host: library-api.example
Authorization: Bearer demo_at_TVW6gksBwL4M

See the complete HTTP exchange for the fictional Reading List client.

Specifications