Skip to content

Edition of June 1, 2025

Acme Store APIAcme Store API

Manage products, orders and customers of an Acme storefront.

Guides

Authentication

Get an access token and keep it fresh.

Every request needs an access token, sent in the Authorization header:

GET https://api.acme.dev/v1/products
Authorization: Bearer <token>

The token flow: log in, call the API, refresh

Logging in

Call POST /auth/login with your email and password. The response contains an access_token that is valid for one hour, and a refresh_token.

Refreshing

Before the access token expires, exchange the refresh token for a new pair with POST /auth/refresh. Never share either token, and never commit them to version control.

Back to the Quickstart.