Getting started

Quickstart

Make your first request in under a minute.

1. Get a token

Exchange your credentials for an access token:

curl -X POST https://api.acme.dev/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "..."}'

curl -X POST https://staging.api.acme.dev/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "..."}'

2. List products

Use the token to list the products of your store (store_42):

curl https://api.acme.dev/v1/stores/store_42/products \
  -H "Authorization: Bearer $TOKEN"

curl https://staging.api.acme.dev/v1/stores/store_test/products \
  -H "Authorization: Bearer $TOKEN"

That's it! Continue with pagination to fetch more than one page of results.